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Course Overview 



IBM Cognos Bl Framework Manager: Design Metadata Models 
(vlO.1) is a five-day, instructor-led course that provides participants with 
introductory to advanced knowledge of metadata modeling concepts, and 
how to model metadata for predictable reporting and analysis results 
using Framework Manager. Participants will learn the full scope of the 
metadata modeling process, from initial project creation, to publishing of 
metadata to the Web, enabling end users to easily author reports and 
analyze data. 

Intended Audience 

. Developers who design metadata models for use in IBM Cognos Bl 

Topics Covered 

Topics covered in this course include: 

. Overview of IBM Cognos Bl 
. Identify common data structures 
. Gather requirements 
. Create a baseline project 
. Prepare reusable metadata 
. Model for predictable results 
. Create calculations and filters 
. Implement a time dimension 
. Specify determinants 
. Create the presentation view 
. Work with different query subject types 
. Set security in Framework Manager 





. Create analysis objects 

. Manage MUNs in Framework Manager 

. Model for drill-through in Framework Manager 

. Advanced generated SQL concepts and complex queries 

. Use advanced parameterization techniques in Framework Manager 

. Model maintenance and extensibility 

. Optimize and tune Framework Manager models 

. Work in a multi-modeler environment 

. Manage OLAP data sources 

. Manage packages in Framework Manager 

Course Prerequisites 

Required: 

. Knowledge of common industry standard data structures and design 
. Experience with SQL 

. Experience gathering requirements and analyzing data 

Recommended: 

. IBM Cognos Bl Report Studio: Author Professional Reports 
Fundamentals (vlO.1) or CBT equivalent 




Document Conventions 



Conventions used in this guide follow Microsoft Windows application 
standards, where applicable. As well, the following conventions are 
observed: 

Bold Bold style is used in demo and workshop 

step-by-step solutions to indicate either: 

• actionable items 

(Point to Sort, and then click Ascending.) 

• text to type or keys to press 

(Type Sales Report, and then press Enter.) 

• Ul elements that are the focus of attention 
(In the Format pane, click Data) 

Italic Used to reference book titles. 

CAPITALIZATION All file names, table names, column names, and 

folder names appear in this guide exactly as they 
appear in the application. 

To keep capitalization consistent with this guide, 
type text exactly as shown. 





Workshops 



Workshop Format 

Workshops are designed to allow you to work according to your own 
pace. The workshops are structured as follows: 

The Business Question Section 

The first page of each workshop presents a business-type question 
followed by a series of steps. These steps provide additional information 
to help guide you through the workshop. Within each step, there may be 
numbered questions relating to the step. Solve the tasks by using the 
skills you learned in this module and in previous ones. If you need more 
assistance, you can refer to the Task Table section that provides more 
detailed instruction. 

The Task Table Section 

The second page of the workshop is a Task Table that presents the 
question as a series of numbered tasks to be accomplished. The first 
column in the table states the task to be accomplished. The second 
column, "Where to Work", indicates the area of the product to work in. 
Finally, the third column provides some hints that may help you complete 
the workshop. If you need more assistance to complete the workshop, 
please refer to the Step-by-Step Instructions at the end of the workshop. 

The Workshop Results Section 

This section will contain a screen capture(s) of interim or final results 
and/or answers to the questions asked in the Business Question section. 

The Step-by-Step Section 

The Step-by-Step instructions for completing all of the tasks are located 
at the end of the workshop following the Workshop Results section. Each 
task in the Task Table is expanded into numbered steps, scripted like the 
demos. 





Your Feedback 

Your feedback is important and valuable. We are interested in your 
comments or questions. 

Please address them to: 

Attn: Senior Manager, Customer Education 

E-mail address: cognos.education@ca.ibm.com 





IBM Product Help 

Help type When to use 



Location 



Task- 

oriented 


You are working in the product and 
you need specific task-oriented help. 


IBM Product - Help link 


Books for 

Printing 

(.pdf) 


You want to use search engines to find 
information. You can then print out 
selected pages, a section, or the whole 
book. 


Start/Programs / IBM 
Product/ Documentation 




Use Step-by-Step online books (.pdf) if 
you want to know how to complete a 
task but prefer to read about it in a 
book. 






The Step-by-Step online books contain 
the same information as the online 
help, but the method of presentation is 
different. 




IBM on the 
Web 


You want to access any of the 
following: 

• Services and Training Web site 

• Online support 

• IBM Web site 


http:/ /www.ibm.com/ 
Cognos/services 

http:/ /www.ibm.com/ 
Cognos/ support 

http:/ /www.ibm.com 
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IBM COGNOS FRAMEWORK MANAGER: CREATE METADATA MODELS (V10.1) 



Business Analytics ^==^"§: 

Course Objectives 

■ At the end of this course, you should be able to: 

■ model metadata so that end users can easily and 
accurately author reports and analyze data 

■ manage projects, packages, and security 

■ create analysis objects by providing dimensional 
information to the model 

■ analyze generated SQL 

■ work with parameters and model for drill through 

■ optimize and tune models for performance 

Coanos. 

software 

©2010 IBM Corporation 



IBM Cognos BI Framework Manager: Design Metadata Models (vlO.l) is a five- 
day, instructor-led course that provides participants with introductory to advanced 
knowledge of metadata modeling concepts, and how to model metadata for predictable 
reporting and analysis results using Framework Manager. Participants will learn the full 
scope of the metadata modeling process, from initial project creation, to publishing of 
metadata to the Web, enabling end users to easily author reports and analyze data. 

Intended Audience 

• Developers who design metadata models for use in IBM Cognos BI 
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Overview of IBM Cognos BI 

Identify Common Data Structures 

Gather Requirements 

Create a Baseline Project 

Prepare Reusable Metadata 

Model for Predictable Results: 

Identify Reporting Issues 

Model for Predictable Results: 

Virtual Star Schemas 

Model for Predictable Results: 

Consolidate Metadata 

Calculations and Filters 

IBM Cognos Framework Manager: Create Metadata Models (vlO.l) 

software 

©2010 IBM Corporation 



Throughout this course, Framework Manager concepts and procedures are grouped 
into modules that are presented in a logical and structured manner. The hands-on 
demonstrations and workshops provide the knowledge and skills you will require to 
create and modify reports in Query Studio. 

Prerequisites 

Required: 

• Knowledge of common industry standard data structures and design 

• Experience with SQL 

• Experience gathering requirements and analyzing data 

Recommended: 

• IBM Cognos Report Studio: Author Professional Reports Fundamentals (vlO.l) 
or CBT equivalent 
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Business Analytics 

Implement a Time Dimension 

Specify Determinants 

Create the Presentation View 

Work with Different Query Subject Types 

Set Security in Framework Manager 

Create Analysis Objects 

Manage MUNs in Framework Manager 

Model for Drill Through in Framework Manager 

Advanced Generated SQL Concepts and 
Complex Queries 

IBM Cognos Framework Manager: Create Metadata Models (vlO.l) software 
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Use Advanced Parameter Techniques in Framework 
Manager 

Model Maintenance and Extensibility 
Optimize and Tune Framework Manager Models 
Work in a Multi-Modeler Environment 
Manage OLAP Data Sources 
Manage Framework Manager Packages 



IBM Cognos Framework Manager: Create Metadata Models (vlO.l) 
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Additional Training Resources 

Bookmark www.ibm.com/cognos/training for details on: 

■ instructor- led training in a classroom or online 

■ self-paced training that fits your needs and schedule 

■ comprehensive curricula and training paths that help 
you identify the courses that are right for you 

■ IBM Cognos Certification program 

■ other resources that will enhance your success with 
IBM Cognos software 

Cognos. 

software 
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IBM Cognos BI 




Business Analytics 
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Business Analytics =§: 

Objectives 

■ At the end of this module, you should be able to: 

■ describe IBM Cognos Business Intelligence (BI) 
and Financial Performance Management (FPM) 

■ describe IBM Cognos BI components 

■ describe IBM Cognos architecture at a high level 

■ define IBM Cognos groups and roles 

■ explain how to extend IBM Cognos BI 

Cognos 

software 
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IBM Information on Demand 



Customer and Product 
Profitability 



Financial 
Risk Insight 



Workforce Dynamic 
Optimization Supply Chain 



Multi-channel 

Marketing 



End-to-End 

Capabilities 



Business Optimization 



Better Business Outcomes 





Business Intelligence and Finance 
Performance Management 


3l 


Plan, understand and optimize 
business performance 


Information integration, Warehousing 
and Management 


Establish and maintain an 
accurate, trusted view of 
information 



Flexible Architecture for Leveraging Existing Investments 




Data Content Other 

Management Management Information 

Sources 



Manage data and content 
over its lifetime and 
as part of processes 



Oognos. 

software 



©2010 IBM Corporation 



IBM's Information On Demand strategy helps you achieve better business outcomes 
for customer and product profitability, increased financial risk insight for better 
business decisions, an optimized workforce, more dynamic supply chain management, 
and support for multi-channel, event driven marketing initiatives. The strategy is 
focused on unlocking the business value of information for competitive advantage. 
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Business Analytics 

IBM Cognos BI and FPM 

■ Good decisions are the building blocks of great 
business performance. 

■ Understand and improve your business based on: 

■ How are we doing? 

■ Why are we doing well or not doing well? 

■ What should we be doing? 

■ IBM provides financial performance management 

through software, services, best- practices, and 
partners. X 

©2010 IBM Corporation 



Use IBM Cognos as an open, enterprise-class, platform to answer the following: 

• How are we doing? Measuring and monitoring performance with scorecards and 
dashboards tracks your key metrics. 

• Why are we getting these results? Reporting and analysis let you see data, gain 
context, understand trends, and spot anomalies. 

• What should we be doing? Planning, budgets, and forecasts let you set and share 
a reliable view of the future. 

IBM Cognos consists of IBM Cognos BI and IBM Cognos FPM, which are based on a 
common underlying architecture. 

This module focuses on IBM Cognos BI. 
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Business Analytics 



IBM Cognos BI Components 



IBM Cognos Connection 


IBM 

Cognos 

Viewer 


Business 

Insight 


Business 

Insight 

Advanced 


Query 

Studio 


Report 

Studio 


Analysis 

Studio 


Event 

Studio 


Metric 

Studio 


Administration 



t t t 



Framework Manager ■ Transformer ■ Metric Designer 



t 



A 



Dimensional 



r 



Relational 







Files 



7 



IBM W 

Cognos I other 
Content m 



Cognos. 

software 

©2010 IBM Corporation 



IBM Cognos BI capabilities provide reporting, analysis, scorecarding, dashboarding, 
business event management, and data integration from a wide array of data sources. 
IBM Cognos BI includes a portal (IBM Cognos Connection) for BI content 
presentation, management, and administration, and various studios to author and 
analyze corporate data. Framework Manager is a metadata modeling tool used to create 
basic query packages or relationally-based dimensional analysis packages. Transformer 
is a modeling tool used to create PowerCubes for dimensional analysis. Each publishes 
packages to IBM Cognos Connection, which are used by authors and analysts in the 
IBM Cognos studios. Metric Designer is used to create scorecard applications for use in 
Metric Studio. 
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Business Analytics 



IBM Cognos BI Architecture (high level) 




Tier 2: Applications 



IBM Cognos BI server 



Tier 3: Data 



IBM Cognos BI 
Content Store 




IBM Cognos BI 
Metric Stores 



Query Data Sources 



Cognos. 

software 
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IBM Cognos BI is a Web-based architecture, which is separated into three tiers; Web 
server, applications, and data. 

This architecture is scalable from a software and hardware perspective. For example, 
you can have several IBM Cognos servers for faster response times and load balancing. 

IBM Cognos leverages existing corporate IT resources such as web servers, 
authentication providers, and application servers, and also supports multiple languages 
and locales in order to serve a global audience. 

IBM Cognos is customizable to adopt your corporate look and feel and can be 
extended and integrated into other applications through the IBM Cognos SDK. 
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Business Analytics 



IBM Cognos BI Groups and Roles 

■ IBM Cognos BI provides default groups and roles for 
security such as: 



System 

Administrators 

Business Authors, 
Professional Authors 

Dashboard Users 



Query Users 



Analysis Users 



Consumers 
Cognos Reporting Application Consumers 



Cognos. 

software 
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Take advantage of IBM Cognos BI groups and roles to secure your IBM Cognos 
environment and content. The group or role to which a user belongs determines how 
much access the user has to the IBM Cognos environment. For example, if you are a 
member of only the Consumers role, you cannot access any of the IBM Cognos 
studios. 

Besides the default groups and roles, you can create new groups and roles that are 
specific to your IBM Cognos needs. Simply add users from your authentication source 

to specific groups and roles as required. 

Not only can you use the groups and roles defined in the IBM Cognos Namespace to 
control access to contents, you can use groups in your authentication provider as well. 
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Purpose: 

As an introduction to IBM Cognos Bl, you will briefly explore one of 
the modeling tools, IBM Cognos Connection, and various Bl studios 
to familiarize yourself with the environment and Bl workflow. 

Task 1. Explore IBM Cognos Framework Manager. 

You will examine a model in IBM Cognos Framework Manager. 

1. From the Start menu, point to All Programs\IBM Cognos 10, and then click 

IBM Cognos Framework Manager. 

2. Click Open a project, navigate to D:\Program Files\IBM\cognos\clO\ 
webcontent\samples\models\great_outdoors_warehouse, and then click 
great_outdoors_warehouse.cpf. 

3. Click Open. 
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4. If security is enabled, log in as admin (password Educationl!) . 
The result appears as follows: 




IBM Cognos Framework Manager is one of the modeling tools used to create 
packages for use in the IBM Cognos studios. This particular tool is primarily 
used to create metadata models based on relational data sources. Its purpose is 
to reduce the complexity of the underlying data source by creating user-friendly 
views of the business for authors and analysts in the IBM Cognos environment. 
IBM Cognos Framework Manager can also be used to model and publish SAP 
BW metadata packages as well as publish other O nlin e Analytical Processing 
(OLAP) packages such as Microsoft Analysis Services cubes. 
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5. In the Project Viewer pane, expand go_data_warehouse\Database view\ 
Sales and marketing data. 

The result appears as follows: 



Project Viewer 



E- 






godatawarehouse 

g o_ d a t d_ w a r e h o u s e 
lti-rH HR (analysis) 

0-O Sales and Marketing [analysis) 
FH -rn Finance [analysis) 

0-0 HR [query) 

m-rn Sales and Marketing [query) 

+1-0 Finance [query) 

+1-0 Filters 



Database view 



Employee data 



GO data 



Sales and marketing data 
i IS SLS_SALES_FACT 
E ll S LS_S ALE S_T AR G E T_FACT 
0 SS MRK_PROMOTION_FACT 
0 i9 M R K_PR 0 M 0 T 1 0 N_PLAN_FACT 



Metadata modelers work in a project with several object types to create 
organized views of the business with any required business logic, and remove 
any ambiguity that might occur. These views are then placed in packages and 
published to IBM Cognos Connection. 
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6. Collapse go_data_warehouse, and then expand Packages. 



The result appears as follows: 

Project Viewer 

- go_data_warehouse 

go_data_warehouse 
s-toi Data Sources 
ET [gp Parameter Maps 
rh - f^l Pac kages 

:• ^ GO Data Warehouse (analysis) 
GO Data Warehouse (query) 



Packages can be a subset of the metadata model, or the entire model depending 
on the requirements. Once published, authors and analysts can choose from the 
objects contained in the package to create reports, analyses, and so on. Take 
note of the package names, as you will see them in IBM Cognos Connection 
shordy. 



7. Expand Data Sources. 



The result appears as follows: 



Project Viewer 


□ @ go 

a-l3l 

&"(n 


i_data_warehouse 

go_data_warehouse 
Data Sources 


_D 


|Q go_data_warehouse | 



Data Sources contain the information that IBM Cognos uses to connect to and 
retrieve data from the underlying data sources cited in the model. 

8. Close IBM Cognos Framework Manager. 
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Task 2. Explore IBM Cognos Connection. 

You will review the centralized portal and navigate the content structure of packages 
and reports. 

1. Start Internet Explorer and navigate to http:/ /localhost:88/ibmcognos. 

2. If security is enabled, log in as admin, password Education!.!. 

The result appears as follows: 




By default, you are presented with a welcome page from which you can choose 
several activities to perform, such as to query or analyze your data, or perform 
administrative tasks. Depending on the role to which you belong to as a user, 
you may have more or less capabilities in the IBM Cognos environment. 
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Click IBM Cognos content. 



The result appears as follows: 



IBM Cognos Connection 



Admin Person Log Off 




■LILT 



Public Folders 



My Folders 



Public Folders 






8 t 




c5 m rj a 






* IS 



Entries: [l 



x 

- fi 1101 i e 



ITI | j Name 0 


Modified 0 


[ Actions 


f"i n Samples 


June 24, 2010 2:45:34 PM 


[Tlf More... 



Here you will find public content, found on the Public Folders tab, or personal 
content, found on the My Folders tab. You also have the ability to create more 
personal tabs to suit your needs or to share with others. Content, including 
reports, analyses, and portal pages, are managed and organized in this area. 
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4. Click Samples, and then click Models. 
The result appears as follows: 




Notice the packages named GO Data Warehouse (analysis) and GO Data 
Warehouse (query). These are the packages you saw in the IBM Cognos 
Framework Manager project earlier that have been published here. 

Packages, by default, are indicated by a blue folder, and regular folders are 
yellow in color. Both types of folders can contain reports, analyses and other 
content. 
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5 . 



1-16 



Click GO Data Warehouse (query), and then click Report Studio Report 
Samples. 

The result appears as follows: 



□ 1 




Ha m e 0 


r 


m 


► Bursted Sales Performance Report 


□ 




► Employee expenses (report; 


r 


» 


► Health Insurance 


r 


a 


► Pension Plan 


r 


& 


► Reaular Salary 


r 


a 


► TOC report 


□ 


& 


► Total Revenue by Country 



Here you see several reports based on the GO Data Warehouse (query) 
package, a model based on a relational data source. 
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Task 3. View reports in IBM Cognos. 



You will open an existing report based on a relational package and a report based on a 
dimensional data package. 

1. Click Total Revenue by Country. 

The result appears as follows: 




(Q Keep this version ▼ j j ^ ^ ^ ▼ j Y| ▼ |1^ Add this report ▼ | [k^ 




Revenue 


Golf Equipment 


Outdoor Protection 


Personal Accessories 


Camping Equipment 


Mountaineering Equipment 


Total(Product line) 


Asia 


Australia 4 Golf only 


3, 186,790.6 


1,551. 16 


1,827,033.78 






5,015,375.54 


Pacific 


Beach Beds Pty Ltd. 


4,137,155.17 


293,119.01 


5,330,905.74 


15,788,255.05 




25,549,434.97 




Black Stump Camping Supplies 




7,719 


2,464,224.32 


1,262,948.49 


462,817. 16 


4,197,708.97 




Blue Mountains Golfing Company 


8,257,037.18 


69 


1,797,644.23 






10,054,750.41 



The report is displayed in IBM Cognos Viewer. When the Total Revenue by 
Country link was clicked, the report was mn and the underlying relational data 
source was queried for data. This query is needed because there was no saved 
output for the report. If the report had been previously mn and saved, the 
saved version, by default, would appear in IBM Cognos Viewer. The report 
would display a snapshot of the data at the time it was last mn and in the format 
specified by the person who ran the report. Formats include HTML, PDF, 
Excel, and XML. 




2. Click Return LhI in the top right corner. 

You will now mn a report based on an OLAP data source. 
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Click the Samples link shown below: 



fBM Cognos Connection 






Pu blic Fold ers 



Mv Folders 



Public Folders >j samplej =- Models > GO Data Warehouse :'querv: > Report Studio Report Samples 



Name 



m ► Bursted Sales Performance Report 



Using the path illustrated here, you can easily navigate the content found in 
IBM Cognos. 

Click Cubes, click Sales and Marketing (cube), and then click Report 
Studio Report Samples. 
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5. Click Top Retailers by Country, from the prompt select Extra Sport, and 
then click Finish. 





A section of the result appears as follows: 



A section of the result appears as follows: 



Revenue 


Prior YTD 


2006 Q 1 






Camping 

Equipment 


Personal 

Accessories 


Golf 

Equipment 


Products 


Rank 


Camping 

Equipment 


Personal 

Accessories 


Golf 

Equipment 


Products 


Rank 


Netherlands 


Extra 

Sport 


4,071,999.30 


1,827,962.56 


1,895,885.69 


7,840,179.54 


1 


1,938,651.69 


751,609.57 


798,976.58 


3,513,563.71 


1 



9.000. 000.00 

8 . 000 . 000.00 

7.000. 000.00 

6 . 000 . 000.00 
= 5,000,000.00 

p 

£ 4,000,000.00 

3.000. 000.00 

2 . 000 . 000.00 
1,000,000.00 

0.00 

CampingEquipment GolfEquipment 

Personal Accessories Products 

Prod uct Set 

Again, the report is displayed in IBM Cognos Viewer. This report is based on a 
PowerCube package and uses dimensional functions to perform common 
OLAP-style queries to compare revenue from selected top retailers for product 
sets across various time periods. 

Click Return in the top right corner. 




Prior YTD, Q3 

Prior YTD 
♦ 2006 Q1 
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Task 4. Create an analysis. 

With Analysis Studio, you will create a report, drill down to lower levels of detail, filter 
for the top two product types in a product line, and then drill through to another report 
for further analysis of the data. 

1 . Click Launch in the top right corner, and then click Analysis Studio. 

Analysis Studio starts in a new browser window. 

2. Click Default Analysis, and then click OK 
A section of the result appears as follows: 




Analysis Studio opens with the default analysis. You can now drill down or up 
on the columns and rows to analyze your data. 

3. Click the Camping Equipment column header to drill down on camping 
equipment data. 
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4. Click the 2007 row header to drill down on 2007 data. 



The result appears as follows: 



Rows: 



Columns: 



i 2007 



Camping Equipme... 



Revenue 


Cooking Gear Lanterns 


Packs 


Sleeping Bags 


Tents 


Camping Equipment 


2007 Q 1 


2 5, 062., 258. 57 


11,830,104.37 


33,518,289,67 


28.058.995.76 


47,030.494.69 


145,500,143.06 


2007 Q 2 


24, 598,809. 14 


12,010,021.92 


36,703,402,93 


29,036,477.17 


51,072, 191.35 


153/5-70,902.51 


2007 Q 3 


8,652,732.64 


4, 194, 349.25 


12,936, 104,39 


11,534,535.24 


16,571, 562.83 


53,939,284.40 


2007 Q 4 












MO 7 


58,313,800.35 


28,034,475.54 


83,157,796.99 


68,730,008.17 


114,674,248.92 


352,910,329.97 




You will now identify the top two sellers for Camping Equipment using the 
Top or Bottom feature. 

5. On the toolbar, click Top or Bottom 

6. In the Define top or bottom filter dialog box at the bottom of the page, click 

Camping Equipment. 

7. Under Top or bottom, select Top, and then under Number of items, type 2. 
The results appear as follows: 



Define top or bottom fitter 


- Camping Equipment 




Limit the results to the top or bottom items of a selected set. If the selected set contains a filter r tiie 


applies only to the results of the filter. 

Top or bottom: Number of items: 


By measure: 


0None 


® 2 


Default (Revenue) 


@Top 


O io % i 


For row: 


0 Bottom 


Quo 


Default 


OK Cancel 
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8. Click OK. 



The analysis now appears with the top two se lli ng items under Camping 
Equipment based on Revenue. 



The result appears as follows: 



Rows: 






Columns: 




■ 


2007 








Camping Equipme... 


- 




Filters are a 


pd lied. See the Properties pane for more details, 









Revenue 


| Tents 


Packs 


Subtotal (included) 


Camping Equipment 


2007 Q 1 


47, 0 30 , 494. 69 


33., 513, 239.67 


£ 0,548,, 7-64. 3 6 


145,500,143.06 


2007 Q 2 


51,072,191.35 


36,703,402,93 


£7, 775,594.28 


153,470,902.51 


2007 Q 3 


16,571, 562.88 


12,936,104.39 


29,507,667.27 


53,939,284.40 


2007 Q 4 








2007 


1 14,6 74,246 .9 2 


£3,157,796.99 


197,832,045.91 


352,910,329.97 



9. Click 2007 to d rill up. 

10. From the data tree, drag Order method to the columns. 



A section of the result appears as follows: 



Revenue 


Telephone 


Sales visit 


Web 


Sp 


1 

2004 


43,315,033.73 


32,809,658.63 


68,436,913.91 




2005 


26,588,351.09 


24,028,463.24 


151,936,538.15 




2006 


10,139,286.41 


19,056,607.94 


238,215,023.04 




2007 


5,132,030.02 


13,154,582.08 


175, 571_.842.62 






Time 


85,174,701.25 


89,049,311.89 


634,160,317.72 





If configured, you can d rill through to a related report to obtain more details 
about your analysis. This feature works for all report types, such as Report 
Studio reports and Query Studio reports. You will now drill through to a related 
report for this analysis. 
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11. Right-click the intersection of Telephone and 2007, point to Go To, and then 
click Related Links. 



The result appears as follows: 



Available Kinks; 



I Name 




DriinroPPS T 




MeasureDr T 
Fackacedrill T 



I Target 

Public Folders > Samples > Cubes > 
Public Folders > Samples > Cubes > 
Public Folders > Samples > Cubes > 



You are presented with three related links. 



1 2. Click MeasureDrill. 



You are presented with a report displaying detailed information related to your 
analysis that is filtered for the year 2007 and the Telephone order method type. 

A section of the result appears as follows: 



Americas 


2007 




Order method type 


Product type 


Product 


Revenue 


Planned revenue 




Telephone 


Binoculars 


Seeker 35 


79,823.94 


84,021.42 








Seeker 50 


52,234.00 


54,985.10 








Seeker Extreme 


22,560 . 20 


23,747. 10 








Seeker Mini 


17,831.60 


18,323.20 








Opera Vision 












Ranger Vision 










Binoculars 


17 2,499.74 


1-61,576.82 






Climbing Accessories 


Granite Carabines" 


18,952.00 


13,952.00 








Granite Belay 


29,725. 50 


31,290.00 



13. Close IBM Cognos Viewer, and then close Analysis Studio. 

14. Click OK when prompted to navigate from the page without saving changes. 
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Task 5. Create an ad hoc query. 



You will use Query Studio to query a relational package and create a grouped list report. 
Then, you will create a new grouped list report based on a dimensionally modeled 
relational package that you will drill down on for more detail. 




2 . 

3 . 





In IBM Cognos Connection, click Home 




in the top right corner. 



By default, this action brings you back to the root of Public Folders. You have 
the option to set a different location as your home page if you wish. 



When you are not in a package folder, you will be prompted to select a package 
when you start a studio. 



From the Launch menu, click Query Studio. 



In the List of all packages section, click Samples, click Models, and then 
click GO Data Warehouse (query). 

This is a package based on a relational model. OLAP-style queries are not 
possible with this package. 

In the data tree to the left, expand the Sales and Marketing (query) folder 
and the Sales (query) namespace, and then add the following items to the 
report by double-clicking the query item: 

• Time query subject: Year query item; Month query item 

• Products query subject: Product line query item; Product type query item; 
Product query item 

• Sales fact query subject: Revenue query item 

Click the Year column header, and then Ctrl-click Month, Product line, and 
Product type. 
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7 . 

8 . 

9 . 



On the toolbar, click Group 




A section of the result appears as follows: 



Year 


Month 


Product line 


Product type 


Product 


Revenue 


200*4 


April 


Camping Equipment 


Cooking Gear 


TirailChef Canteen 


176,1*47. 19 










TrailChef Cook Set 


683,365.59 










TrailChef Cup 


94,837.97 










TrailChef Deluxe Cook Set 


931,220.16 










TrailChef Double Flame 


536,370 










TrailChef Kettle 


391,123.76 










TrailChef Kitchen Kit 


316,457 










TrailChef Single Flame 


746,007.3 










TrailChef Utensils 


156,793.08 










TrailChef Water Bag 


564,566.87 








Cooking Gear 


4 r 59« r SSS.9Z 








Lanterns 


EverGlow Butane 


128,730.1 



This is a basic list report with some grouping applied to make the report easier 
to read. You will now create a similar report but using a dimensional package. 



In order to create a report with a different package, you will need to close this 
session of Query Studio, and launch the studio with the different package. 



Click IBM Cognos Connection 

if prompted to save changes. 




in the top right corner, and then click No 



From the Launch menu, click Query Studio. 



On the List of all packages, click Samples, click Models, and then click GO 
Data Warehouse (analysis). 



This package is based on a dimensionally modeled relational (DMR) model. 
This means that the model developer has provided dimensional information to 
a relational model to allow authors and analysts to perform OLAP-style queries 
at mn time on a relational data source. 
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10. In the data tree to the left, expand the Sales and Marketing (analysis) folder 
and the Sales namespace, and then add the following items to the report by 
dragging each to the report layout: 

• Time dimension: Year level; Month level 

• Products dimension: Product line level; Product type level; Product level 

• Sales fact dimension: Revenue fact 



Note: Instead of query subjects and query items, you are now dealing with 




dimensions ■ I , levels I I and facts 





1 1 . Group the report on Year, Month, Product line, and Product type. 

The result appears as follows: 



Year 


Month 


Product line 


Product type 


Product 


Revenue 


2004 


January 2004 


Camping Equipment 


Cooking Gear 


TrailChef Canteen 


240,837.99 










TrailChef Cook Set 


747,929.81 










TrailChef Cud 


103,359.04 










TrailChef Deluxe Cook Set 


975,374.4 










T railChef Double Flame 


672,015.15 










TrailChef Kettle 


433,465.42 










TrailChef Kitchen Kit 


446, 124. 18 










TrailChef Sinofe Flame 


775,939.5 










TrailChef Utensils 


333,300.55 










T railChef Water Baa 


337,150.31 








Cooking Gear 


5,171,046.35 








Lanterns 


EverGlow Butane 


155,000.72 










EverGlow Double 


47,443.9 3 



Notice that this report contains underlined items, in this case, Month and 
Product. You can d rill down on these items to further analyze your data. The 
same type of behavior applies to OLAP data sources. 
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12. Click January 2004, and then click TrailChef Water Bag. 

The result appears as follows: 




The report is now focused on the dates TrailChef Water Bag items were sold in 
the month of January 2004. 

13. Right-click TrailChef Water Bag 1110, and then click Drill Up. 

14. Right-click 20040112, and then click Drill Up. 

You will now open this report in Report Studio to add a corporate graphic and 
a prompt page. 
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Task 6. Enhance an ad hoc report in Report Studio. 

You will enhance a report that was created in Query Studio, by using Report Studio to 
add a corporate graphic and a prompt. You will then save the report to IBM Cognos 
Connection. 

1. Under Menu, on the left side of the page, click Manage File, and then click 

Open in Report Studio. 

A section of the result appears as follows: 




The report, which opens in Report Studio, can now be enhanced with features 
that are not available in Query Studio. You are now in a design environment 
and if you wish to see the data returned by the report, you must mn the report. 
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2 . 

3 . 



4 . 

5 . 

6 . 




Under Insertable Objects, click the Toolbox 
Drag an Image object to the left of the Title box. 
The result appears as follows: 



tab. 






Title 



Right-click the image item in the report layout, and then click Edit Image 
URL. 



Click Browse, in the list, select logo_great_outdoors.gif, and then click OK 
Click OK, and click Title to remove focus from the image object. 

The result appears as follows: 




You will now add a prompt page to your report to allow users to filter on a 
particular year of data. 
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( V 1 0 . 1 ) 



7 . 



1-30 



In the report layout, click the Year column header, and then on the toolbar, 



click Build Prompt Page 



The result appears as follows: 
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On the toolbar, click Run Report 



¥\ 



The result appears as follows: 




Select all Deselect all 
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( V 1 0 . 1 ) 



9. Select 2007, and then click Finish. 



A section of the result appears as follows: 




The report displays the image you inserted as well as data for the year 2007. 

This is a simple example of enhancing a report with Report Studio. Report 
Studio is capable of many advanced authoring techniques to create professional, 
dynamic, and robust reports. 



10. Close IBM Cognos Viewer, and then in Report Studio, on the toolbar, click 
Save 




11. Under Save in, click My Folders, and then in the Name box, type Product 
Revenue: Select Year. 

12. Click Save, and then close Report Studio. 
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In Query Studio, click IBM Cognos Connection 

exit without saving the report. 




and then click No to 



14. In IBM Cognos Connection, click the My Folders tab. 



The result appears as follows: 




The report that you saved is displayed. You can save your report to any location 
that you have access to. You can also copy/ cut and paste your report and other 
objects to organize content in the portal. 
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Task 7. Customize a dashboard in Business Insight. 

You will use Business Insight to customize and use a dashboard. You will modify a 
filter, delete an element, add a report part, save the dashboard, and add an annotation 
to the report data. 



1 . 



2 . 



3. 



In IBM Cognos Connection, from the Launch menu in the top right corner, 
click Business Insight. 

On the IBM Cognos Business Insight Getting Started Page, click Open 
Existing, navigate to Samples > Models > Business Insight Samples > 
Marketing Dashboard, and then click Open. 

The dashboard opens in Business Insight, displaying a Slider Filter, a Select 
Value Filter, and four report widgets. 




From the Actions Menu I I, click Save As, and then save the dashboard in 

My Folders as My Marketing Dashboard. 



4. In the Slider Filter, drag the slider to 2006 . 

The Slider Filter appears as follows: 




The report widgets that communicate with this Slider Filter will refresh their 
displays to reflect the modified filter requirements. 

You want to delete one report widget to customize your dashboard. 
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5. Click the Promotion plan versus promotion revenue report widget, click the 
widget Actions menu, click Remove from Dashboard, and then click 
Remove to confirm. 




7. 

8 . 



You want to change the layout of the dashboard. 

Click the Slider Filter and drag it near the top of the canvas, and then repeat 
with the Select Value Filter and the Advertising cost by year report widget. 



A section of the results appear as follows: 



Promotion data 



Year 



Product line 



u 

E 

ra 

C 

C 

O' 

m 

Cl 

E 

fXJ 

O 




^ Revenue 
Gross profit 



0 20 , 000.000 40.000 000 60 000,000 80.000 000 



Advertising cost 




Camping Equipment Golf Equipment Mountaineering Equipment 



Select a value Select a value 

2004 2005 2006 2007 y (Select All) 

1 I I ‘ 

2006 



Apply Cancel 



Camping Equipment 
Golf Equipment 
Mountaineering Equipment 
Outdoor Protection 
Personal Accessories 



Advertising cost by year 


Camping 


Golf 


Mountaineering 




Outdoor 


Personal 


Equipment 


Equipment 


Equipment 




Protection 


Accessories 


Direct mail advertising 


912,787 


670,281 




577,752 


24,131 


3,914,145 


cost 














Email advertising cost 


751,310 


402,202 




377,308 


26,410 


4,789,812 


Magazine advertising 


1,765,861 


448,164 




520,412 


42,555 


4,231,821 


cost 














Radio advertising cost 


1,688,485 


1,151,573 




922,474 


40,163 


4,190,023 


Television advertising 


1,898,208 


757,968 




484,873 


43,140 


2,024,396 


cost 














Sponsorships cost 


1,133,756 


1,135,841 




696,126 


112,990 


2,978,830 



On the Business Insight toolbar, click Content 






<< Content 



On the right side, a content pane displays Content and Toolbox tabs. 

On the Content tab, navigate through the tree by expanding Public Folders > 
Samples > Models > GO Data Warehouse (query) > Report Studio 
Report Samples. 

You can see the reports stored in the folder. Usually, a report would be the end 
of your navigation capability, however Business Insight allows you to leverage 
report parts in existing reports. 
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9. Click the arrow beside the Total Revenue by Country report. 

The tree expands to display charts and lists that exist in the current report. You 
want use one of these report parts in your dashboard. 

10. Click Crosstablllll, and drag it to the canvas, below the Advertising cost by 
year report widget. 

A new report widget is placed on the canvas, and the crosstab is displayed. 

You want to add a comment about the data displayed in the chart. First, you 
will save the dashboard. 



1 1 . From the Business Insight toolbar, click Save. 

12. In the new crosstab report widget, click the intersection of Harbour Pty Ltd. 
and Camping Equipment. 



The crosstab cell with 571,323.6 is highlighted. 

13. Click the mouse cursor over the top of the report widget to reveal the widget 

toolbar, click Comment TL, click Add Comment, and then in the text 

box enter the following comment: Investigate which order methods are 
used, and then determine what should change to improve revenue. 



14. Click Done. 



A small red triangle at the top right of the cell indicates that a comment is 
available for reviewers. 



15. Hover the mouse cursor the red triangular marker. 

The comment displays, with the name of the author and the date and time that 
the comment was added. Reviewers who see this dashboard, can review this 
comment, and add their own comments. 



432,703.36 


F n|B 

Admin Person \ 


E71 ,323.6 'K 


Jul 30, 2010 10:55:16 AM 1 


Filter applied Show 


2,751.417.54 
4 .E6 7,592. 3 3 
1.047,333.26 


571,323.6 - Investigate which order methods are 
used^ and then determine what should change to 
improve revenue. 

, , , 4 
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16. From the Business Insight toolbar, click Save. 

17. Close the dashboard window to return to IBM Cognos Connection. 

Task 8. Author a report in Business Insight Advanced. 



You will use Business Insight Advanced to author a report, include a calculation for 
analysis of the data, and customize your data by changi n g measures. 



1 . 

2 . 

3. 



4. 

5. 

6 . 

7. 



In IBM Cognos Connection, from the Launch menu, click Business 
Insight Advanced. 

In the List of all packages, click Samples, click Models, and then click GO 
Data Warehouse (analysis). 



Click Create new, and then double-click Crosstab to open a new crosstab 
report. 

Business Insight Advanced opens, with a report layout area on the left, and the 
data tree displayed in the Insertable Objects pane on the right. By default, the 
tree displays members. 

In the Insertable Objects pane, on the Source tab, expand the Sales and 
Marketing (analysis) folder, and then expand the Sales folder. 

Expand Time. 



There are 4 members displayed in Time: 2004, 2005, 2006, and 2007. 



In the toolbar above the Source tab, click View Metadata Tree 




On the Source tab, expand the Sales and Marketing (analysis) folder, 
expand the Sales namespace, and then expand the Time dimension. 

The Time hierarchy is displayed. This is different from step 4, where only the 
members were displayed. 
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8. Expand the Time hierarchy. 

Under the Time hierarchy, the Members folder is displayed, along with levels 
such as Year and Quarter. 

9. Expand the Members folder, and the Time member. 

Within the Members folder, is the Time member, and the members 2004, 2005, 
2006, and 2007. 

With dimensional data, you can quickly select the view which displays the 
elements you want to work with by using the View Members Tree button or the 
View Metadata Tree button. 

10. In the toolbar above the Source tab, click View Members Tree L7Z_I. 

1 1 . From the Insertable Objects pane > Source tab, expand the Sales and 
Marketing (analysis) folder > Sales folder, and then add the following items 
to the report by dragging each to the report layout: 

• Columns drop zone: Time 

• Rows drop zone: Products 

• Measures drop zone: Sales fact > Revenue 

The results appear as follows: 



Revenue 


2004 


2005 


2006 


2007 


Time 


Camping Equipment 


332,966,338 06 


402,757,573.17 


500,362,422.63 


352,910,329.97 


1,539,036,664.03 


Pers d n a 1 Access □ ries 


391 ,647,093.61 


456,323,355.9 


594,009,403.42 


443,693,449 35 


1,335,673,307.73 


Outdoor Protection 


36,165,521.07 


25,003,574.03 


10,349,175.34 


4,471,025.26 


75,994,296.25 


Golf Equipment 


153,563,850.96 


163,006,427.07 


230,1 1 0,270.55 


174,740,319.29 


726,411,367.39 


Mountaineering Equipment 


107,099,659.94 


161 ,039,323.26 


141,520,649.7 


409,660,132.9 


Prod ucts 


| 944,352,303.72 


1,159,195,590.16 


1,495,391,100.9 


1 f 1 17,336,274.07 


4,636,775,763.35 



The live data values automatically populate the crosstab as you add each 
element, and there is no need to mn the report separately as you develop it. 
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1 2. From the View menu, click Page Design. 



The results appear as follows: 



<#Ti me#> 



Revenue <#chikJren(Tinne:(#> 

<#ch ild ren (Prod u cts )#> <#1 2 34#> -=#1 2 34#> 

<#1234*> <#1234#> 



<#Prod ucts#> 



The crosstab is now filled with placeholders, instead of the live data. You can 
see the set of members of Time and Products, in the columns and rows 
respectively, and the Revenue measure placeholders. When working in Page 
Design mode, to see the data values you will mn the report. 

13. Click a cell in the crosstab, on the Insertable Objects pane > Toolbox tab, 
drag a Chart object below the crosstab. 
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14. In the left pane click Bar, in the right pane click Clustered Cylinder Bar with 



3-D Effects 

click OK 






, click the Fill with data check box to select it, and then 



The bar chart is displayed below the crosstab. The chart is automatically 
populated with the data items (as placeholders) from the crosstab. 



Revenue 


<#children(Tinr>B>#> 


<#Time#> 


<#ch ild ran i Pro d u cts }#> 


<#1234#> 


<#1234#> 


| <#Products#> 


<#1234#> 


<#1234#> 



lW> 




(Default Legend Title) 



0 



m n 






Data utt maas u rs (x-ax sj : 



< Rsvan ye > 



Saras (primary axis): 



<£child re n ( F red u cts)#> 



Categories (y-axs): 



<sfchildran(Time)#> 



1 5. From the View menu, click Page Preview. 

The crosstab and chart display actual data values. 
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16. Click the title text to change the focus from the chart. 
The results appear as follows: 



Revenue 



C a nip in g Equipment 
Pers o n a I Access o ries 
Outdoor Protection 
Golf Equipment 
Mountaineering Equipment 



Products 



2004 


2005 


2000 


2007 


Time 


332,956,335.00 


402,757,573.17 


500,352,422.53 


352,910,329.97 


1,509,036,664.03 


391 ,047,093.61 


450,323,355.9 


594,009,405.42 


443,093,449.55 


1,005,673,307.70 


30,105,521.07 


25.005,574.05 


13,349,175.54 


4,471.025.20 


75,994,296.25 


1 53.553.S50.9S 


105,000,427.07 


230.1 1 0,270.55 


174,740,519.29 


726,411,367.09 




107,099,059.94 


101,039,523.20 


141,520,049.7 


409,660,132.9 


914,352,003.72 


1,159,195,590.16 


1,495,091,100.9 


1,117,336,274.07 


4,606,775,760.05 


Products 



2QQ7- 



20OB- 



OJ 

E 



2005- 



2004- 




| Camping Equipment 
| Personal Accessories 
| Outdoor Protection 
[] Golf Equipment 
| Mountaineering Equipment 



1 r 

20D.0CO.C-D0 400,000,000 

Revenue 



000 , 000,000 



A 
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17. In the lower right corner of the chart, drag the resize corner to enlarge the chart 
to be the same width as the crosstab. 

Charts can easily be resized using this method. 

Now that you have reviewed the revenue for the product lines over the years, 
you want to change the measure to display quantity. 

1 8. On the Insertable Objects pane > Source tab, under Sales fact, click 
Quantity, and drag it to the measures area on the crosstab. 

The crosstab displays the new measure. 

19. Right-click the chart, and then click Update Chart from Crosstab. 

The chart updates to display the quantity values based on the crosstab. 

You want to analyze the previous year-to-year percent difference of quantity for 
2005 and 2006. To do this, you will create a variance calculation, using a preset 
calculation in Business Insight Advanced. 

20. In the crosstab, click the 2005 column header and then Shift-click the 2006 
column header. 
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21. Right-click 2006, click Calculate, and then click % Difference (2005, 2006). 

A new column displays the calculated values for you to review. 



Quantity 


2004 


2005 


2.006 


2007 


% Difference (2005, 2006) 




Camping Equipment 


5 , S9 5 . 0 53 


6,903,764 


3,399,156 


6,103,176 


21.66% 


27,301,149 


Pens o n a 1 Access o ries 


7,572,339 


3,567,357 


10,706,015 


3,061,994 


24.96% 


34,907,705 


Outdoor Protection 


5,614,356 


4,111,053 


1,599,535 


6-39,446 


-61.09% 


12,014,445 


Golf Equ ipment 


1,092,932 


1 ,297,793 


1,536,772 


1,136,154 


18.41% 


5,113,701 


Mountaineering Equipment 




2,644,713 


3,700,262 


3,555,116 


39.91% 


9,900,091 




20,174,730 


23,524,635 


25,941,790 


19,595,336 


m 27% 


39,237,091 



2EX37- 



2 DOG - 



as 

E 



2005- 



2034 - 




Products 

] Camping Equipment 
| Personal Accessories 
| Outdoor Protection 
] Golf Equipment 
| Mountaineering Equipment 



i ! ! i i 1 r 

a I.UDO.DOO 3.0D0.D00 5.000,000 7,000,000 

Quantity 



S.ODO.DOQ 



1 1 . 000.000 



A 



22. In Business Insight Advanced, from the Report Actions menu, click Exit, 
and do not save changes. 

You are returned to IBM Cognos Connection. 
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Task 9. Explore preferences. 




On the IBM Cognos Connection toolbar, click My Area Options 




The result appears as follows: 

My Inbox 
My Watch Items 
My Preferences 
My Activities and Schedules 

i" ^ — 1 

Here you can view and manage: 



11 



• Inbox (notification requests and ad hoc tasks) 

• watch items (user-specified mles to receive alerts based on values in a report) 

• personal preferences 

• activities and schedules (such as reports you are running or have mn in the 
past, as well as reports you have scheduled to mn) 
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Click My Preferences. 

A section of the results appear as follows: 



Set preferences 



General 



Personal 



Specify your settings. 



Portal Tabs 



Number of entries in list view: 
15 



Separators in list view: 
| No separator 




Style: 

| Corporate “3 Preview 



n 



Show hidden entries 



Report format 
| HTML 

R Show the Welcome page at startup 
F Show a summary of the run options 
I - Enable accessibility support for reports I run or schedule 



Portal! 

Default view: 

(* List 

C' Details 

N u m b e r of colu m n s in d eta ils view: 
1 3 columns T | 



Regional! options 
Product language:: 

* Use the default language 

C Use the following language: 




Content language: 

* Use the default language 

C Use the following language: 

| English 



Time zone: 

* Use the default time zone 
P Use the following time zone: 

| (GMT-05 : 00) Eastern Time: Ottawa r New York, Toronto, Montreal, Jamaica, Porto Acre 





On this tab you can configure your personal portal preferences. For example, 
you can change the UI language and, if your data and metadata support it, you 
can change your content language as well. 
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3 . 



1-46 



Click the Personal tab. 



A section of the result appears as follows: 



Set preferences 



Help 



General 



Personal 



Portal Tabs 



View the summary of your authentication information and manage your credentials. You can also view the groups and idles 
whose access permissions you have in this session and the capabilities available to you. 

Primary logon 



The primary logon represents the namespace that you first logged on to in this session and the credentials that you used. 

Namespaces 

LDAP 

User ID: 
admin 

Given name; 

Admin 

Surname: 

Person 

Email: 

admin@artdl23.com 



Alerts 



Specify the email address to use for your alerts about new versions. 



Email: 



On this tab you can see your personal information as well as which groups and 
roles you belong to and which capabilities you have in the IBM Cognos 
environment (not all elements are shown in the screen capture) . Depending on 
your authentication provider and capabilities, information on this page will 
differ. 



©2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 

or translated into another language without a legal license agreement from IBM Corporation. 




OVERVIEW OF IBM COGNOS Bl (V10.1) 



4. Click the Portal Tabs tab. 
The result appears as follows: 




Here you can manage your portal tabs such as adding removing tabs or 
changing the order of the tabs. 

5. Click Cancel. 
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Task 10. Explore IBM Cognos Administration. 

1 . From the Launch menu, click IBM Cognos Administration. 

The result appears as follows: 




This portion of the portal requires administrative access and allows you to 
monitor and administer IBM Cognos including servers, security, capabilities, 
data source connections, and the deployment of content. 

2. Click Log Off, and then close Internet Explorer. 

Results: 

As an introduction to IBM Cognos Bl, you briefly explored one of the 
modeling tools, IBM Cognos Connection, and various Bl studios to 
familiarize yourself with the environment and Bl workflow. 
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Business Analytics 



Extend IBM Cognos BI 

■ IBM Cognos provides a wide variety of ways to extend 
IBM Cognos BI. 

■ For more information, please visit the IBM Cognos 
Web site 

http : //www-0 1 . i bm . com/softwa re/data/cog nos/ . 
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Summary 

■ At the end of this module, you should be able to: 

■ describe IBM Cognos Business Intelligence (BI) 
and Financial Performance Management (FPM) 

■ describe IBM Cognos BI components 

■ describe IBM Cognos architecture at a high level 

■ define IBM Cognos groups and roles 

■ explain how to extend IBM Cognos BI 
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Business Analytics 



Objectives 

■ At the end of this module, you should be able to : 

■ examine the characteristics of operational 
databases and databases designed for reporting 

■ examine relationships and cardinality 

■ identify different data traps 

■ examine OLAP data sources 
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Examine the Role of an IBM Cognos Metadata 
Model 

■ An IBM Cognos metadata model provides a business 
presentation view of an organization's data sources. 

■ BI users use the model to analyze and report on their data 
sources. 



Reporting Layer 



I 



IBM Cognos Metadata Model 



t t t t 

A 



Cubes 



software 
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Other 



Relational 



Files 



y 



An IBM Cognos metadata model can hide the structural complexity of your underlying 
data sources. By creating an IBM Cognos metadata model, you have more control over 
how your data is presented to IBM Cognos end users. You can also choose which data 
to display to your end users and how it will be organized. The overall goal of modeling 
the metadata is to create a model that provides predictable results as well as an easy-to- 
use view of the metadata for authors and analysts. 

This module will focus on industry standard data structures. This knowledge is essential 
before beginning a metadata modeling project. Framework Manager topics will be 
covered in subsequent modules. 
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• Operational databases are: 

• used to track the day-to-day operations of a business 

• usually normalized or part of an enterprise resource planning (ERP) vendor 
package 

• Reporting databases are: 

• typically a copy of the operational data 

• structured differently from operational databases to make reporting faster and 
easier 

• usually dimensional, taking the form of a star schema design 



©2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 
or translated into another language without a legal license agreement from IBM Corporation. 



2-5 



IBM COGNOS FRAMEWORK MANAGER: DESIGN METADATA MODELS (V10.1) 



Business Analytics 

Identify Features of an Operational Database 

■ Operational databases: 

■ are designed to maximize accuracy and minimize 
redundancy 

■ are optimized for writing and updating data rather 
than reading data 

■ often result in monolithic designs with multiple 
joins 

■ Large queries can perform slowly. 

Coanos. 

software 
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It can be difficult to report from an operational database because: 

• reading the data can impact the performance of the system 

• the number of tables that must be joined to satisfy a business question can be 
prohibitively large 

• a more complex database requires more metadata modeling efforts to make it 
consumable by business users 
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Customer 

Type 



Sales 

Area 



The query must check data 
in seven tables before 
returning a result set. 



tomer 



Sales 

Rep 



0..n 



1..1 



Order 

Header 



1..1 



Order 

Detail 



0..n 



Identify Issues with Operational Databases 

■ "Show all customer types 
that bought from a product 
line." 



Product 



l..n 


1. 


1 


Prodi 


ICt 


Ty 


p| 






1 


p 


l..n 






ProdJ 


ICt 



rr.i 



Query requires 7 tables 
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Operational databases may be too complex for general reporting. As a result, reports 
that are generated against these structures may take a long time to mn. They may also 
have unpredictable results. 

As shown in the slide example, a report may need to access many tables to retrieve all 
the necessary data. 
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Examine Reporting Databases 
(Star Schema Design) 

■ Transactional data is stored in a fact table 

■ Reference data is stored in separate dimension tables 





Sales 

Rep 






0..n 


1..1 




Customer 


1..1 

Q..n 


Order 
Fact 


1..1 

Q..n 


Product 






1..1 


0..n 








Date 





Query only requires 3 tables cognos. 
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A star schema is a design with two basic components: 

• a central table, known as the fact table (typically numeric data) 

• satellite tables, known as the dimension tables 

Because a star schema database contains fewer tables than a fully normalized database, 
query performance is much faster. 

• A typical query against a star schema database focuses on the central fact table 
and makes integrity checks against the related dimension tables. 

• If the query is to retrieve information about a specific subject area only, such as 
all the products that belong to a particular product line, then the query will be 
even faster. 
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Each table in a star schema database will contain an expanded set of data. 

Extract Transform and Load (ETL) tools can be used to create a star schema data 
warehouse, or you may use a metadata modeling tool to emulate a star schema structure 
by generating the appropriate SQL at report design time. The second option will not 
improve performance, but will yield predictable results. 



©2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 
or translated into another language without a legal license agreement from IBM Corporation. 



2-9 



IBM COGNOS FRAMEWORK MANAGER: DESIGN METADATA MODELS (V10.1) 



Business Analytics 



Examine Operational Data 



■ Data is normalized 

Product Table 



4 rows 



Before collapsing into a star schema dimension cognos. 
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PT# 


Prod# 


Prod_Desc 


1 


101 


1 Sleeper 


1 


102 


2 Sleeper 


2 


201 


4 Sleeper 


2 


203 


6 Sleeper 


11 


1101 


Wet Proof 


12 


1102 


Hikers+ 



6 rows 



Product Line Table Product Type Table 



PL# 


PL_Desc 


a 


Classic Tents 


b 


Moose Boots 



2 rows 



PL# 


PT# 


PT_Desc 


a 


1 


Pup Tents 


a 


2 


Family Tents 


b 


11 


Child Boots 


b 


12 


Adult Boots 



The slide example shows three normalized tables that represent three hierarchical levels. 
Products roll up into product types, and product types roll up into product lines. 

The Product Line table has two rows that indicate two lines of products sold by the 
company. 

The Product Type table contains four rows to indicate the four types of products that 
fall under the previous two product lines (two types per product line) . 

The Product table contains the greatest level of detail. It holds 6 rows to represent the 6 
products that fall under the four product types. 
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Examine Reporting Data 

■ Data is de-normalized 



Product Dimension Table 



PL# 


PL_Desc 


PT# 


PT_Desc 


Prod# 


Prod_Desc 


A 


Classic Tents 


1 


Pup Tents 


101 


1 Sleeper 


A 


Classic Tents 


1 


Pup Tents 


102 


2 Sleeper 


A 


Classic Tents 


2 


Family Tents 


201 


4 Sleeper 


A 


Classic Tents 


2 


Family Tents 


203 


6 Sleeper 


B 


Moose Boots 


11 


Child Boots 


1101 


Wet Proof 


B 


Moose Boots 


12 


Adult Boots 


1102 


Hikers 



6 rows 



After collapsing into a star schema dimension cognos. 
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The slide example shows a de-normalized dimension table created from the three 
normalized tables shown on the previous slide. 

The Product Line table forms the first two columns of the new dimension table (PL# 
and PL_Desc), the Product Type table forms the next two columns (PT# and 
PT_Desc), and the Product table forms the last two columns (Prod# and Prod_Desc). 

The main characteristic of this table is its redundancy. Note that each product line 
(Classic Tents and Moose Boots) is repeated, once for each product that the product 
line contains. The same applies for product type. 

This type of table is unsuitable for a norm ali zed system, but is ideal for a reporting and 
querying structure. 
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Examine Fact Tables 

■ Fact tables contain the (usually additive) values by 
which a company measures itself: 

■ Standard Selling Price - not additive 

■ Sale Amount - additive 



Measures 



Foreign Keys 



Fact Table 



Sales Revenue 
Quantity 

Product Key 
Customer Key 
Time Key 



Dimension Tables 





Product 






Customer 






Time 
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Fact tables are the focal point of any star schema, and typically contain the most rows. 
There are typically no descriptive attributes in a fact table. Instead, there are foreign 
keys that relate to the dimension tables, which contain descriptive attributes. 

Facts in a fact table are also known as metrics, measures, or key performance indicators. 
There are cases where you may encounter facdess fact tables, in which only foreign 
keys are found. For example, in the case of a library, you may have a fact table that only 
contains a book key, a customer key, and a day key, which records which books were 
checked out by which customer and when. 
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Examine Dimension Tables 

■ Dimension tables provide descriptive information. 

■ Dimension tables may be "conformed" so that they 
are applicable to multiple fact tables across the 
business. 



Dimension 



Fact 



Sales 



Dimension 



Customer 



/ 


Product 




7 


\ 

Dimension / 


> 


Time 






/ 



Dimension 



Warehouse 



Fact 



Inventory 



Conformed Dimensions 
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Conformed dimensions prevent "islands of information" by providing context to 
multiple potential queries. A conformed dimension is one which is common to several 
fact tables; it has the same meaning and content when being referred to from several 
fact tables. 

In the slide example, you can query either sales or inventory data through the Product 
dimension table, the Time dimension table, or both. For example, Product acts as a 
context when you want to compare quantity sold with stock count. 
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Business Analytics 

Identify Issues with a Star Schema 

■ Data is only as current as the last data load. 

■ Structural issues: 

■ the distinct count problem 

■ very large dimension tables 

■ snowflakes 

■ Fact issues: 

■ different levels of granularity (detail) in fact tables 

Coanos. 
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Unlike an operational database, the data is not live. Data is periodically loaded from an 
operational system into the reporting database (star schema layout) . Therefore the data 
is only as current as the last time it was loaded. 

When reporting against a star schema database, you may encounter difficulties in 
counting the exact number of items in the dimension, such as separate products. 

The star schema may also include large dimension tables that result in reports that mn 
too slowly. These tables may be broken out into smaller tables through a normalization 
process, which in turn creates snowflake tables. 

In some cases, fact tables can have different levels of granularity. For example the data 
values may either be associated with the day level or the month level. The granularity 
may change based on the dimensions referenced in the fact table. 
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Define Relationships 

■ Specify how data in one table is linked to data in 
another table. 

■ Relationships are implied in the physical data 
(modeler explicitly declares these relationships) 

■ Modeler formulates the reality of the business by 
configuring the relationships 
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A relationship states a connection or an operational business rule, such as: 

• a sales representative sells a product 

• an employee is assigned to a department 

Relationships work in both directions. You often have to examine both directions to 
fully understand the relationship. For example: 

• a branch is composed of employees 

• an employee may work directly for a branch 
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Examine Relationships: Cardinality 

■ One-to-One: One employee 
holds exactly one security 
number. 



■ One-to-Many: Each order 
header must have one or more 
order details. 

■ Many-to-Many: Each part may 
be provided by many 
suppliers, and each supplier 
may provide many parts. 

Cognos* 
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Cardinality indicates the number of instances of an entity in relation to another entity. 

One-to-one relationships occur when one unique row in a table relates to exactly one 
row in another table. For example, each employee can only have one security number. 
One security number can only be associated with one employee. 

One-to-many relationship example: an order is taken and an Order Header table is 
populated with data such as date, customer name, and sales staff name. This table is 
related to an Order Details table that contains data about individual items sold in that 
one order, such as order detail code, product number, and quantity. Therefore a 
relationship exists between Order Header and Order Details, whereby each Order 
Header must contain one or many Order Details, and each Order Detail must appear 
on one and only one Order Header. 

Many-to-many relationships occur when many unique rows in a table relate to many 
rows in another table. The slide example shows that many suppliers may provide a 
single part. However, a single supplier may provide many parts. 
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Examine Relationships: 

Optional vs. Mandatory 

■ Relationships may be mandatory or optional. 

■ For example, a product may exist even if it has 
not been ordered, but an order must refer to at 
least one existing product. 

■ It is important to determine if certain relationships 
are optional. 

■ For example, is there a reporting requirement to 
list sales representatives who have sold nothing? 

Coanos. 
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A relationship is mandatory when a row of data in one table must exist in order for a 
row of data in another table to exist. 

A relationship is optional when a row of data in one table does not have to exist in 
order for a row of data in another table to exist. 
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Business Analytics 

Examine Relationships: Data Traps 

■ There are four basic data traps: 

■ chasm trap (many-to-many relationship) 

■ transitive relationship trap (more than one path 
between two tables) 

■ connection trap (an optional path through 
different entities) 

fan trap (multiple one-to-many relationships that 
fan out from a single table) 

Cognos. 
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A trap does not necessarily indicate a problem, only that an area is worth inspection 
and possible refinement. 

The data modeler must carefully examine any area that does not appear to represent the 
data completely. 
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In a chasm trap, more than one row in a table is related to more than one row in 
another table. 

The slide example shows that a single supplier may provide many parts, and many 
suppliers may provide a single part. 

If each supplier can potentially supply every single part, how do you report on the 
suppliers that provide specific parts? 

This is typically resolved with a "bridge" table that records the details of the relationship 
between the two tables. 
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A transitive relationship trap resembles a wheel shape. 

This kind of trap may make it difficult to write queries that retrieve the appropriate 
data, because it may not be clear which table columns must be included in the query. 

Going through either path produces some sort of result, but which path is the correct 
or more efficient one for your specific query? 
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Fan traps are also known as parallel relationships. 

In this kind of trap, a table has two one-to-many relationships spreading out from it, 
implying that the two other tables have no connection to each other. 

The modeler should examine such traps to determine whether a cmcial relationship is 
missing. 

Branch may actually have a direct relationship to Employee. 
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The slide example suggests that there may be a direct relationship between the 
Employee and Division tables. 

An employee may be able to work directly for a division, instead of working for a 
branch within a division. For example, the employee may work from a home office. 
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Examine OLAP Data Structures 



Order Methods 




r 



Dimension 



Members 



Fax 



Telephone 



Mail 



Jan 



Feb 



Q1 



Q2 



E-Mail 

Web 



2005 


2006 

















Hierarchy/Levels 




2005 Q1 



Q2 



Q3 



Q4 




Products 

Camping Equipment 

Golf Equipment 

Outdoor Protection 

Mountaineering 

Equipment 

Personal Accessories 









/ 


Start 


End 




April 1 


June 30 



Attributes 
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The OLAP structure consists of the following elements: 

• dimensions - contain members, which may be structured into hierarchies and 
levels 

• hierarchies - provide context to the level structures they contain 

• levels - provide structure for the members of a hierarchy 

• members - data entities that provide context to cell values 

• attributes - provide additional information about members 

• cells - are intersection points containing values (measures) for various members 
from different dimensions (also referred to as tuples) 
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Identify Data Access Strategies 

■ Consider using a cube to analyze data sets that are 
not prohibitively large. 

■ Consider creating a star schema to improve 
performance over an operational system. 

■ If you need to access live data, you may have no 
choice but to go with an operational system. 
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The methods that you use to access your data for reporting purposes will be 
determined by your needs and by the structure and content of the data itself. 

What are acceptable performance times for your reports? If the information is required 
quickly (within seconds), consider using cubes. However, if the data set is extremely 
large, cubes may not be the solution and you may want to consider using a data mart or 
warehouse with pre-aggregated tables. 

If you require live data, you may need to go direcdy against your operational system. 
Remember that reporting direcdy against a normalized operational system may yield 
poor performance and may slow down the writing of data to the database. 

Planning and scope should be given a great deal of attention before embarking on a 
business intelligence project. 
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Summary 

■ You should now be able to : 

■ examine the characteristics of operational 
databases and databases designed for reporting 

■ examine relationships and cardinality 

■ identify different data traps 

■ examine OLAP data sources 
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Business Analytics 

Objectives 

■ At the end of this module, you should be able to 
examine key modeling recommendations 

■ define reporting requirements 

■ explore data sources to identify data access 
strategies 




Cognos, 

software 

©2010 IBM Corporation 



©2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 
or translated into another language without a legal license agreement from IBM Corporation. 



3-3 



IBM COGNOS FRAMEWORK MANAGER: DESIGN METADATA MODELS (V10.1) 



Business Analytics 



Modeling Recommendations Overview 

1. Define reporting requirements and data access 
strategies 

2. Import only required reporting objects in a phased 
approach and alter as little as possible 

3. Verify relationships and query item properties 

4. Model in freehand to identify query usage 

5. Use model query subjects to control query 
generation and usage and to consolidate metadata 



cont'd... 
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These recommendations will be expanded upon as you progress through the course. 
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Business Analytics == 

Modeling Recommendations Overview 
(cont'd) 

6. Customize metadata for run time 

7. Specify determinants as required 

8. Resolve multiple ambiguous joins between query 
subjects 

9. Create analysis objects if OLAP-style querying is 
required 

10. Create the business view as a set of star schema 
groupings 
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Business Analytics 

Analyze BI and Data Requirements 

" " Recommendation #1 

■ Identify the business-intelligence-related problems to 
be solved 

■ What is your data access strategy? Consider: 

■ reporting versus operational 

■ metadata 

■ multiple data sources 

■ modeling requirements 

■ relationships 

Cognos. 

software 
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Problems to be solved include setting the scope of your project and setting its 
methodology, as well as multilingualism, performance, security, and presentation. 

Do you and the IBM Cognos users agree on the model requirements? 

Does the data source contain the data and metadata you need? 

Does the same data exist in more than one source? 

Which data source tables are the fact tables, which are the dimensions, and which are 
both fact tables and dimensions? What are the keys and attributes of each dimension? 

Do fact tables contain only facts and foreign keys? Do they also contain dimensional 
attributes that should be in dimension tables? 

What are the required relationships and are there multiple paths between tables? 
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Interview and View Samples 

■ Interview authors and users to determine needs 

■ View reports that IBM Cognos will be replacing 
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Ralph Kimball (author on the subject of data warehousing and business intelligence) 
recommends an interview-based approach to determine report requirements. The focus 
is on what information the key business decision makers require to do their jobs. This 
will result in a framework of key performance indicators (KPI) and business contexts. 
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Business Analytics 

Your Data Source for this Course 

■ You will work with the Great Outdoors Company 
operational relational database called GOSALES 

■ Presents more modeling scenarios for you to master 

■ You will focus on a small portion of this database to 
develop a sales reporting model 
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This course will use the Great Outdoors Company operational database called 
GOS ALE S in order to build a sales reporting model. 

Although a reporting (star schema) database is recommended for performance and ease 
of use, in this course you will model an operational system to provide you with a wider 
variety of modeling techniques and prepare you for more data scenarios back at your 
place of work. 
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Before creating a Framework Manager project, you must: 

• analyze and understand your reporting requirements based on the 
business process that authors will be reporting on 

• understand your data and the structure of your data source(s) 

Upon interviewing BI users, you discover that they would like to report on sales 
data by the dimensions shown in the slide example above. 
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Business Analytics 



Identify Required Business Areas (cont'd) 

Recommendation #1 
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BI users would also like to report on sales targets by the dimensions shown above. 
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Business Analytics 



Identify Required Business Areas (cont'd) 

Recommendation #1 
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And finally, BI users would like to report on returns by the dimensions shown above. 

Knowing this information, you interview the database administrator to find out 
where this information can be obtained. You are told it is in the GOS ALE S 
database. 
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Business Analytics 



Work in Stages 



Recommendation #2 



■ A common tendency is to immediately import all 
metadata to meet all reporting requirements 

■ can create a complex set of objects to work with 
as a starting point 

■ Recommended approach: 

■ develop model in stages; start with a subset of 
report requirements 

■ import additional metadata as needed 

■ revisit and revise as required (iterative 

development) cognos. 

software 
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For your course model, the scenario is that you have interviewed functional users and 
have determined that you will start with a baseline project that allows reporting on sales 
by product or by order method. This postpones work on sales staff, location, retailer 
(your customers), sales targets, and returns. 

As you progress in your modeling activities, you may discover other requirements or 
the data itself may present you with other reporting options that were not thought of 
by the end users. 
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Demo 1 : Identify Data Sources (Instructor-only) 



Purpose: 

As the Data Modeler for The Great Outdoors Company, your task 
is to develop a model that supports the business requirements of 
report and ad hoc query authors working with Cognos. Before 
you begin the modeling process, you will locate the data sources 
identified as necessary to meet those reporting requirements. 



Component: IBM DB2 Control Center 

Task 1 . Open DB2 Control Center. 

1 . From the Start menu, point to All Programs > IBM DB2 > DB2COPY > 
General Administration Tools, and then click Control Center. 

2. In the Control Center View dialog, select the Basic radio button. 

3. Click OK, expand All Databases > GS_DB, and then click the Tables folder. 

Task 2. Investigate Tables. 

The sales reports will be focused on orders, so note the ORDER_DET AIL S, 
ORDER_HEADER, and ORDER_METHOD tables. 

1 . Click ORDER_HEADER to view details for the ORDER_HEADER table 
in the Details pane. 

You can identify the tables related to the ORDER_HEADER header table by 
looking for foreign keys. Here you can see several keys: ORDER_NUMBER, 
RETAILER_SITE_CODE, RETAILER_CONTACT_CODE, 
SALES_STAFF_CODE, S ALES_BRAN CH_CODE, and 
ORDER_METHOD_CODE. You will now examine some of these 
relationships. 
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2. Click ORDER_DETAILS to view details for the ORDER_DET AIL S table 
in the Details pane. 

You can see the facts needed for many reports: QUANTITY, UNIT_COST, 
UNIT_PRICE, and UNIT_SALE_PRICE. You also see ORDER_NUMBER, 
confirming the relationship to ORDER_DETAILS. You also see 
PRODUCT_NUMBER. You will confirm that this is the link to the Product 
data. 

3. Scroll down the list of tables to the PRODUCT table. 

You can see a series of tables whose names start with PRODUCT_, so you will 
have to view each one to decide if they contain data that meets the reporting 
requirements. 

4. Click PRODUCT to view details for the PRODUCT table in the Details pane. 

You see PRODUCT_NUMBER, confirming that this is the link to the sales 
(ORDER DET ATT.) data. Upon asking the database administrator about 
BASE_PRODUCT_NUMBER, you learn that this is for handling multiple 
brands of a given product. You see several codes, indicating foreign keys to 

PRODUCT_TYPE, PRODUCT_COLOR, PRODUCT_SIZE, and 
PRODU CT_BRAND . You also see the product facts you were looking for to 
report on: PRODUCTION_COST and GROSS_MARGIN. However you 
don't see a product name or description field. You will have to keep looking. 
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5. Click PRODU CT_TYPE to view details for the PRODUCTTYPE table in 
the Details pane. 

You see PRODUCT_TYPE_CODE, confirming the link to PRODUCT. You 
also see PRODUCT_LINE_CODE (which you can confirm links to 
PRODU CT_LINE in a three-level hierarchy; product line>product 
type>product). 

Note the many PRODUCT_TYPE_ _xx columns. This is one form of 
multilingual support, a column for each language. Later in the course, you will 
see how you can modify the metadata so that authors and consumers can access 
a single product type column, which will automatically return the appropriate 
language based on the user's regional settings. Recall that you did not see such a 
list of columns for the name of the product itself in PRODUCT, so that table 
must have a different form of multilingual support. 

6. Click PRODUCT JNTAME_LOOKUP to view details for the 
PRODUCT_NAME_LOOKUP table in the Details pane. 

Now you see PRODU CT_N AME and PRODUCT_DESCRIPTION as well 
as PRODU CT_LAN GU AGE, and you can conclude that this table must have 
multiple language records for each PRODUCT_NUMBER. 

The only outstanding report item required before beginning a baseline project is 
an order method. Recall that ORDER_HEADER holds an 
ORDER_METHOD_CODE column. 

7. Click ORDER_METHOD. 

You see the order method columns; one for each supported language in the 
data. You will need to resolve this multilingual challenge in the same manner 
you will use for PRODUCT_TYPE_xx. 
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8. Close Control Center. 



Results: 

You have identified the following tables as those needed for the 
first phase of your model building, a baseline project. 

- ORDERJHEADER, ORDER_DETAILS, ORDER_METHOD 

- PRODUCT, PRODUCTJYPE, PRODUCTJJNE, 

PRODUCT NAME LOOKUP 
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Business Analytics 

Summary 

■ You should now be able to: 

examine key modeling recommendations 

■ define reporting requirements 

■ explore data sources to identify data access 
strategies 
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Business Analytics =§: 

Objectives 

■ At the end of this module, you should be able to: 

■ follow the IBM Cognos and Framework Manager 
workflow processes 

■ define a project and its structure 

■ describe the Framework Manager environment 

■ create a baseline project 

■ enhance the model with additional metadata 
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Business Analytics 



What is Framework Manager? 

■ Provides the metadata model development environment for 
IBM Cog nos 



Used to create simplified business presentations of metadata derived 
from one or more data sources 
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When you work in Framework Manager, you work in a project. A project contains 
metadata objects (the model) organized for report authors according to the business 
model and rules. 

The modeler’s job is to take the complexity of the underlying data structures and create 
simplified presentations for authors and business analysts that provide predictable 
results. These simplified views are then published as packages to the IBM Cognos 
Connection for use in the BI studios. 
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Business Analytics 



What is Framework Manager? (cont'd) 

■ Can create two model types: 

■ relational for reporting 



■ dimensionally modeled relational (DMR) for OLAP- 
style analysis and reporting 
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Relational models consist of query subjects and within those, query items. 

DMR models consist of dimensional information provided by the modeler, such as 
hierarchies and levels, to allow authors to perform OLAP-style queries. 

These two model types can be developed in the same project and published as separate 
packages. In the slide example, the packages are GO Operational (query) and GO 
Operational (analysis), both published from the same project. 
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Business Analytics 



Define a Framework Manager Project 

■ At the highest level, objects in a project include: 

■ a model organized 
into namespaces 
and folders 

■ data sources 

■ parameter maps 

■ packages 
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The system files of a project consist of a folder containing a project file (.cpf) and a set 
of XML files specific to that project. These files should be backed up or checked into a 
repository control system regularly to prevent data loss. A project contains the 
following objects: 

• Model - the set of metadata objects organized and modeled for report authors. 
The root of the model is a namespace that can contain other namespaces and 
folders, which are containers for organizing objects; however the names of 
objects in a namespace are qualified with the namespace name to uniquely 
identify them. This allows you to have objects of the same name in different 
namespaces. 

• Data sources - information IBM Cognos uses to connect to data sources 

• parameter maps (optional) - a list allowing the substitution of one value for 
another at mn time 

• Package - a subset of the project objects that is published to IBM Cognos 
Connection for use by authors and business analysts. 
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Business Analytics 

Define Framework Manager Metadata 
Elements 



Metadata is defined and organized by the following 
elements: 
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In Framework Manager, you will interact with the following objects: 

• query subject - there are three types: 

• data source: maps to a corresponding object in the data source and uses a 
modifiable SQL statement to retrieve the data 

• model: maps to existing metadata in the model 

• stored procedure: executes a database stored procedure to retrieve or 
update the data 
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• query item - contained within a query subject and maps to a corresponding 
object in the data source 

• relationship - connection that explains how the data in one query subject 
relates to the data in another 

• regular dimension - contains descriptive and business key information and 
organizes the information in a hierarchy, from the highest level of granularity 
to the lowest allowing for OLAP-style queries 

• measure dimension - a collection of facts for OLAP-style queries 

• scope relationship - exists between measure dimensions and regular 
dimensions to define the level at which the measures are available for 
reporting 

• Shortcut - pointer to an underlying object that can act as an alias or reference 
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Business Analytics =^==^?§: 

Examine the Model from the Author's Point of 
View 
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Within IBM Cognos Connection and the various studios, authors interact with a run- 
time version of a subset of the Framework Manager model. This subset, which the 
modeler publishes as a package from Framework Manager to the IBM Cognos server, 
contains metadata that exists in the development model. It is packaged in a structure 
reflecting a viewpoint appropriate for report authors and business analysts. The actual 
data is not published with the package; it is retrieved from the underlying data source at 
run time. 

In Framework Manager, you can create several packages containing different subsets of 
the model. 
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Demo 1: Examine the Final Project 



Purpose: 

Before you begin the modeling process for your Great Outdoors 
model, you will explore the Framework Manager Ul and view the 
final results of the model you will build by the end of this course. 
This will help bring context to the tasks ahead of you. 



Components: Framework Manager, Business Insight Advanced 



Project: 

Package: 



GO Operational 
GO Operational (query) 



Task 1. Examine the Framework Manager Ul and view the 

top-level objects. 

1. Launch Windows Explorer, and then navigate to C:\Edcognos\B5152\ 
CBIFM-Files\Final. 

The results appear as follows: 



Name -*■ 



Rcustomdata.xml 



ri) GO Operational. cpf 
RIDlog.xml 
R log, xml 
R model, xml 
R Preferences, xml 



R session-log .xml 



Here you see the project files for the final Framework Manager model you will 
be building throughout this course. The cpf file is the main project file. The xml 
files store model information, preferences, session logging, action logging (each 
modeling action you make), and so on. 
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2. From the Start menu, point to All Programs > IBM Cognos 10, and then click 

IBM Cognos Framework Manager. 

3. Click Open a project, navigate to C:\Edcognos\B5152\ 
CBIFM-Files\Final, and then double-click GO Operational. cpf. 

4. Log in as admin/Educationl!. 

The results appear as follows: 
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Take the time to examine the different UI elements. 

Project Viewer pane: By default this pane is on the left and provides an easy 

way to access all your project's objects in a tree format. 

Project Info pane: This is the center pane and also provides access to the 

project's objects through various methods. Three tabs 
(Explorer, Diagram, and Dimension Map) allow you to 
create, edit, configure, or delete objects. You will use 
each of these throughout the course. 

Properties pane: This pane allows you to configure various properties for 

any of the project's objects. 

Tools pane: This pane provides several useful tools. You can use it to 

quickly switch the project language in this pane as well as 
view project statistics, and quickly perform common 
tasks for selected objects. This pane also provides a 
search utility (second tab) and an object dependencies 
utility (third tab). Simply drag an object (and its children 
if it has any) to the top panel, select the object or one of 
its children in the top panel and view the dependant 
objects in the bottom panel. This is very useful when you 
want to change an object and assess the impact that the 
change will have on other objects in the model. 

All panes can be hidden except the Project Info pane, which is the main work 
area. To bring them back, simply select them from the View menu or use the 
toggles on the toolbar. You can also detach and rearrange the Project Viewer, 
Properties and Tools panes. 
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Now that you have examined the main elements of the Framework Manager 
UI, take the time to examine the project. 

In the project viewer examine the top level-objects. They are a GO Operational 
Model namespace (contains model objects), a Data Sources folder (contains the 
data sources used in the project), a Parameter Maps folder (contains parameter 
maps that allow for data substitution at mn time), and a Packages folder 
(contains packages that are published to IBM Cognos to make model metadata 
available to authors). 

5. Expand Data Sources, click GOSALES, and then expand Type in the 
Properties pane. 

The results appear as follows: 



Properties Language 


Name 


GOSALES 


Query Processing 


Limited Local 


Rollup Processing 


unspecified 


Content Manager Data Source 


great_outdoors_sales 


Catalog 




Cube 




Schema 


GOSALES 


El Type 




Query Type 


Relational 


Interface 


0L 


Function Set ID 


< Click to edit. > 



Notice the Query Type property indicates that these are relational sources. 
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6. Expand GO Operational Model. 



The results appear as follows: 



Project Viewer 


— 


GC 

g 

+ 

+ 

+ 

+ 


>0| 

GC 

■■g 

g 

g 

g 


peratiional 
* Operational Model 
Presentation View 
Dimensional View 
Consolidation View 
Foundation Objects View 



Notice the four namespaces for logical separation of objects by function. 

Foundation Objects View contains the "base" query subjects; data source 
query subjects as well as any model query subjects used to resolve reporting 
issues. 

Consolidation View is an isolation layer. It is made up of model query subjects 
that are used as containers to consolidate multiple query subjects into one (such 
as Product, Product Type, and Product Line). It also simplifies query subjects 
by hiding codes or organizing them in subfolders. This layer insulates reports 
from potential changes in the underlying data source. 

Dimensional View contains multidimensional objects based on model query 
subjects in the Consolidation View. These are used for OLAP-style queries and 
are based on objects in the Consolidation View. 

Presentation View contains groupings of shortcuts that present the underlying 
objects in a logical presentation. 

These are the naming conventions used in this course. You can use whatever 
naming convention and object organization you are comfortable with. 
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Task 2. View the detail objects. 




Expand Foundation Objects View > gosales. 



The results appear as follows: 



g 



+ 

+ 

0 

+ 

+ 

+ 

+ 

+ 

+ 



gosales 
j|g Sales Fact 
jjgg SALES_TARGET 
Hg Returns Fact 
BRANCH 
[jfjfl Branch Country (alias) 
[jfjQ Branch Region (alias) 
COUNTRY 
EMPLOYEE 






ggg Employee (Human Resources] 

CMDir.VCC UlCTr.DV 



The gosales namespace contains all the data source query subjects (represented 
with a small database icon) created during the import process from the 
GOSALES database as well as model query subjects that are used to alias 
original data source query subjects or to create views (merge query subjects 
together to create "As View" behavior) of original data source query subjects. 



The small yellow angle mler icon indicates the query subject contains measures 
as seen on Sales Fact, S ATE S T ARGET, and Returns Fact. 
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2. Expand SALES_TARGET. 



The results appear as follows: 



- 




SALES TARGET 




SALES_YEAR 

SALES_PERIOD 

CO U NTR Y_COD E_R ETAI LER 

S ALES_STAF F_CO D E 

RETAILER_CODE 

RETAILER_NAME 

PROD UCT_TYP E_CO D E 

PROD UCT_E R AN D_CO D E 



DU SALES_TARGET 



Notice that, with the exception of a few property changes, these data source 
query subjects are untouched after being imported. This is recommended to 
ease maintenance. 

3. Expand Sales Fact. 

The results appear as follows: 

- p/j Sales Fact 

X OR!DER_NUMBBR 
d RETAILER_S:I7E_C0DE 
d RETAILER_COMTACT_CODE 
d SALES_STAFF_CODE 
d SALES_B RANCH JCODE 
L If ORDER_DA7E 
X ORDER_CLOSE_DATE 
X ORDER_METHOD_COOE 
X ORDER_DETAIL_CODE 
L X SHIP.DA.7E 
X IPR00UCT_N UMBER 
d PR0M0T10N_C0DE 
m Revenue 

! [Tel, Quantity 

Q|[ Unit Cost 

[]J[ Draft Pnice 

| - H Urift Sale Price 
[]£ Gross Profit 
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This is a model query subject that is the result of merging two data source query 
subjects together to create "As View" behavior. 

Query items to be used by authors have been given user-friendly names. This is 
not needed for query items that will not be included in the final Presentation 
View. Calculations have also been implemented in this object. 

4. Double-click Sales Fact to open its definition dialog. 

The results appear as follows: 



Query Subject Definition | Filters Determinants | Test 


Query Information 


Available Model Objects: 


Query Items and Calculations: 






b 


GO Operational 1 




N ame 


Source 






&■ 


g 


Presentation View 


i 


ORDERJMUMBER 


Original Sales & Returns Objects.ORDER 






[+!••• 


g 


Dimensional View 




1 R E TAI LE R_S 1 T E_C0 D E 


Original Sales & Returns Objects.ORDER 






m- 


g 


Consolidation View 




1 RETAILER_CONTACT_CODE Original Sales & Returns Objects.ORDER 






a- 


■B 


Foundation Objects View 




SALE S_S T AFF_C0 D E 


Original Sales & Returns Objects.ORDER 














SALE S_B RAN CH_C0DE 


Original Sales & Returns Objects.ORDER 














]*|ORDER_DATE 


Original Sales & Returns Objects.ORDER 














glnRnFR ringp i-iatf 


flnnin^l 5^lg? S.- Rphirn? I~l hipr-K- flRnFR 



Here you can see all the query items that make up the model query subject as 
well as any filters or determinants that might be specified. The source column 
tells you how the query item is derived. You can edit the definition of each 
query item in this dialog by clicking the ellipses in the Source column. You can 
also go directly to the query item definition from the Project Viewer tree. You 
will do this now. 
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Click Cancel, and then double-click ORDER_NUMBER. 

The results appear as follows: 




Here you can see and edit the definition of the query item. The query item can 
be a direct reference to another item, or a calculation. In this case it is a direct 
reference that is broken down as follows: 

[Namespace]. [Query Subject]. [Query Item] 

Click Cancel, and then expand Reusable Objects > Model Calculations. 

The results appear as follows: 

|- ^ Reusable Objects 
- F^p Model Calculations 
H Region 
; Country 
^ Month 

This folder contains several commonly requested calculations (in this case, the 
calculation retrieves a specific language value from the data source) to allow 
maintenance from a single source. 
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7. Expand Consolidation View and Sales Fact. 

The results appear as follows: 



E Q|] Con solid artian View 
El jjy Sales Fact 
rjl Revenue 
Quantity 
U nit Cos t 
[Jljs^ linft Price 
Er fe Unit Sale Price 
Gross Profit 




This namespace is a simplified version of Sales Fact from the Foundation 
Objects View. It only contains the measures (facts), hiding the complex keys. 
This layer is a consistent presentation where all objects simply act as containers 
to consolidate information from the underlying Foundation Objects View. This 
layer also contains calculations, filters, and appropriate naming conventions. 
These are the objects authors will work with direcdy or indirectly. 

Expand Model Filters > Retailer Location Filters. 



The results appear as follows: 



O Model filters 
□■■■& Retailer Location Filters 
v Americas 
Y .Asia Pacific 
¥ Northern Europe 
¥ Central Europe 
¥ Southern Europe 



These folders contain several filters that authors can pick from to simplify 
report filtering. 
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Expand Dimensional View. 



The results appear as follows: 



Dimensional View 
IP Sales Fact 



IQ Returns Fact 
Sales Target Fact 




^ Branch by Location 
^ Order Codes 
^ Order Method 
^ Products 
^ Retailer by Location 
^ Return Reason 
^ Sales Target by Location 
^ Staff by Location 
V Time 



Here you can see dimensions and measures based on objects in the 
Consolidation View. Dimensional information (hierarchies, levels, attributes, 
and so on) is provided in this view. These objects are used for OLAP-style 
queries in Business Insight, Analysis Studio, Query Studio, and Report Studio. 
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10. Expand Presentation View, and then GO Operational Sales (query) and 
GO Operational Sales (analysis). 



The results appear as follows: 



0 



^ Presentation View 

GD Operational Sales (query) 

EE]- -[ID Sales (query) 

Returns (query) 

[i]-[!D Sales Targets (query) 
Retailer Location Filters 
■■^jT My Location 
■■^jF Retailers Near Me 
My Security Info 
GO Operational Sales (analysis) 



Eh* Sales (analysis) 



Returns (analysis) 



0 Sales T argets (analysis) 



□■■■ Call Center Application 



Here you can see two namespaces, one containing objects for queries and 
reports, and the other for analysis. There is also a Call Center Application 
namespace that is specific to a particular application to quickly retrieve order 
information. 
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11. In GO Operational Sales (query), expand Sales (query), and Returns 
(query). 



The results appear as follows: 



GO Operational Sales (query) 



‘gj Sales (query) 

^ Sales Fact 
^ Margin 

Branch by Location 
■ffij Order Codes 
Order Method 
^ Products 
■■gjl Retailer by Location 
Staff by Location 

M Time 

■0fii Time (Close) 

Time (Ship) 



‘SJ Returns (query) 

^ Returns Fact 

Branch by Location 



nni I r.'j.-.r I ■ ."A ■ 



These two namespaces contain shortcuts that logically group the Consolidation 
View objects. Facts are grouped with their related dimensions. The namespaces 
have some overlapping object names (conformed dimensions). To create multi- 
fact queries across multiple areas of the business, include at least one 
conformed dimension. 
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Task 3. View the package as a report author. 

1. Expand Packages, and then double-click GO Operational (query). 
The results appear as follows: 



2 . 



3. 



b-TxFIB 



GO Operational Model 



□ X El [H Presentation View 



EH X E 




m 

0 

0 



✓ 






✓ 






GO Operational Sales [query) 
Sales [query) 

Returns [query) 

Sales T argets (query) 






EH X E 



JS3 Retailer Location Filters 
dV My Location 

Retailers Near Me 
^ My Security Info 
GO Operational Sales (analysis) 



The package contains a subset of the project specific to objects to be used for 
relational queries and reports. 

Click Cancel, right-click GO Operational (query), and then click Publish 
Packages. 

Click Next, click Next, deselect Verify the package before publishing, and 
then click Publish. 



4. Click Finish. 

5. Open your Internet browser and navigate to the following page: 

http: / /localhost:88/ibmcognos. 

6. Log on as admin/Educationl!. 

This will log you in to IBM Cognos Connection. 

7. Click Author business reports, and then click GO Operational (query). 
This is the package you just published. 

8. Click Create new, select List and then click OK 
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In the Insertable Objects pane, ensure the Source tab is selected, and then 
expand Sales (query) and Returns (query). 

Notice that this is the same structure and grouping seen in the Presentation 
View in the previous task. 

Add the following items to the report: 



Query Subject 


Query Item 


Sales (Query) > Products 


Product Line 


Sales (Query) >Time 


Year 


Sales (Query) >Sales Fact 


Revenue 


Returns (Query) >Returns Fact 


Return Quantity 


Click the Product Line column and click the Group 
report on Product Line. 

The results appear as follows: 

i 


“ icon to group the 
1 


Product Lino Yea r 


Revenue 


Return Quantity 




Camping Equipment 2004 


5 3 32 .936, 3 33. 06 


60,966 




2005 


S4 02 .757. 57 3. 17 


66,256 




2006 


5500,332 .422. S3 


97,617 




2007 


5352,910.329.97 


79.604 




Camping Equipment - Summary 


$1,539,036,664.03 


304,443 



- - ~ 






-• h r -t r r -t -■ 



•> •> r-r, 



Using this intuitive view of the metadata, you can create queries quickly and 
easily. 

12. Close the browser without saving the report. 
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13. In Framework Manager, from the File menu, click Close to close the project 
without saving changes. 

Results: 

You explored the Framework Manager Ul and saw some of the final 
results in the model that you will build throughout this course. You 
also saw the benefits of creating a simple-to-use view of the 
metadata for the business. 
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Business Analytics 



Framework Manager Workflow 



Framework Manager 



Create 

Project 




Import 

Metadata 



Prepare 

Metadata 



Publish 



Set 

Security 



Model 

Metadata for 
Reporting 



I 



Create and 
Manage 
Packages 



Data 

Sources 



Content 

Store 



Report Studio 
Query Studio 
Analysis Studio 



Cognos. 

software 



>2010 IBM Corporation 



Import Metadata - import objects such as tables, views, and procedures 

Prepare Metadata - examine and modify properties and relationships 

Model Metadata for Reporting - add business value specific to reporting requirements 
and model for predictable results 

Create and Manage Packages - identify subsets of the metadata to be published 
Set Security - apply security at various levels to restrict access 

Publish - publish packages to the IBM Cognos servers for use by report authors and 
business analysts 
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Business Analytics 



Import Required Metadata 



Recommendation #2 




Cognos 

software 



>2010 IBM Corporation 



Import only the required metadata in a phased approach to minimize clutter in the 
model. 

For relational data sources, choose the model object into which you will import, and 
then do the following: 

1 . Select Data Sources as the import source. 

2. Either select the data source to be used (usually a relational database), or create 
a data source connection and then select it. If you create a data source 
connection, specify the name and type (such as MSSQL, Oracle, DB2); specify 
the connection string (if necessary); specify a signon; and test the connection. 

3. Select the required objects to import; for example, tables, views, or 
procedures. 

4. Select the criteria by which Framework Manager will generate relationships. 
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Business Analytics 



Generate Relationship Criteria 

Relationships are created for you during the import of your data. Select the criteria Id use to 
generate relationships. 

Select at least one cntena to detect and generate rettionshipe. 

W Use pnmary and foreign keys 

l — Use matching query item names that represent uniquely ^deaed columns 
Use matching query item names 

Select between which set of objects you went to detect and gererate relationships 
'■* Between the imported query subjects 

r ' Between each imported query subject and all existing query subjects m the model 
C Both 

Indicate how you want to generate relationships between the imported query subjects. 

Out esr joins: 

'•* Convert to inner join (1 . ji) 

|J " Create outer join (D.ji) 

Granularity: 

W Fact detection enabled (l.n 0,,n) 



Cognos 

software 

©2010 IBM Corporation 



This dialog box is part of the Import Metadata Wizard. 

In general, use the first check box for relational data from the same database. The other 
two check boxes are often used when importing from a different database. 

You can request to create relationships among either the objects being imported, or the 
objects being imported and the existing objects in the model, or both. 

By default, an import converts outer joins to inner joins. This is done for performance 
reasons. You can choose to generate outer joins if that meets your business needs or 
you can edit specific relationships after import to meet your needs. 

Another option is to enable or disable fact detection. If this option is disabled, all 
relationships will be 1..1 to 1..1. 
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Business Analytics 



Requirements Review 



Recommendation #1 




Cognos 

software 
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In the next demo, you will import metadata to satisfy the highlighted reporting 
requirements above. The database tables used to satisfy each requirement are as 
follows: 



Reporting Requirement 


Database Tables 


Sales Fact 


ORDER_DETAILS 
O RD ER_HE AD ER 


Order Method 


ORDER_METHOD 


Product 


PRODUCT 
PRODU CT_LINE 
PRODU CT_NAME_LOOKUP 
PRODUCTTYPE 
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Demo 2: Create a Baseline Project 



Purpose: 

Your first step as a data modeler for The Great Outdoors Company 
is to create a new project, specify the data it will use, and start the 
metadata modeling process. 



Component: Framework Manager 

Project: GO Operational 

Task 1 . Create a project. 

1. Launch Framework Manager, and under Projects, click Create a new project. 

2. In the Location box, click Browse, navigate to C:\Edcognos\B5152 and 
create a new folder called Course_Project. 

3. Select the Course_Project folder, click OK, and then in the Project name 
box, type GO Operational. 

The GO Operational folder is created by default and appears by default in the 
Location box. 

4. Click OK, and then log in as User ID admin, and Password Education!.!, if 
prompted. 

The Select Languages dialog box appears. You will initially set the default and 
design language for this project as English. 

5. Ensure that English is selected, and then click OK. 

The Metadata Wizard appears. You will first organize your project and then 
import metadata into the appropriate location in a later task. 

6. Click Cancel. 

The project opens in Framework Manager. Notice in the Project Viewer that 
the project appears with the name you provided and a default namespace called 
Model. 
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Task 2. Create and organize objects. 




Rename the Model 




namespace to GO Operational Model. 



Tip: You can press F2 to edit the label. 



2. Right-click the GO Operational Model namespace, point to Create, and then 
click Namespace. 

3. Rename New Namespace to Foundation Objects View. 

4. Right-click the Foundation Objects View namespace, point to Create, and 
then click Namespace. 



5. Rename New Namespace to gosales. 



The model appears as shown below: 



GO Operational 

GO Operational Model 



Foundation Objects View 



‘S gosales 



Data Sources 
Parameter Maps 
Packages 



Creating the gosales namespace makes the Foundation Objects View extensible 
in the event you want to import metadata from another data source. At the time 
of the import of the second data source, you would create another namespace 
to contain those data source query subjects. 



You will now begin the process for importing the metadata into the gosales 
namespace. You will start by creating a data source and testing the connection 
to it. 
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Task 3. Create a data source and test the connection. 

1 . Right-click the gosales namespace, and then click Run Metadata Wizard. 

The Metadata Wizard appears. From here you can select the source from which 
you will import the metadata. You will import data from a relational database. 

2. Ensure that Data Sources is selected, and then click Next. 

You are now prompted to select a data source from the list of available data 
sources. The data source you need to access is currently not available. You must 
create a connection to the database from which you are importing metadata. 
You are connecting to the GOSALES database, which is a DB2 database. 

3. Click New. 

The Welcome page of the New Data Source Wizard appears. This is the same 
wizard that is used to create data sources through the Directory tool in the IBM 
Cognos Connection administration interface. 

4. Click Next, in the Name box, type GOSALES, and then click Next. 

5. In the Type list, click IBM DB2, leave the default isolation level, and then click 

Next. 

6. In the DB2 database name box, type GS_DB. 

7. Under Signons, select the Password check box, in the User ID box, type 
GOSALES, and then in the Password and Confirm password boxes, type 
Education!!. 
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8. Click Test the connection, and then click Test. 

The View the results - Test the connection page appears indicating that the test 
succeeded. 

9. Click Close, and then click Close again. 

10. Click Finish, and then click Close. 

A new data source called GOS ALE S, through which you will import metadata, 
now appears in the list. 

You will now take a moment to view this data source in IBM Cognos 
Connection. 

1 1 . Launch IBM Cognos Connection, log on, click on Administer IBM Cognos 
content, and then click the Configuration tab. 

The GOSALES data source appears in the list. You could have also created the 
data source here rather than through Framework Manager. If you need to edit 
the data source connection, you will need to do it in this location. 

12. Close IBM Cognos Connection. 
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Task 4. Import metadata. 

1 . Ensure the newly created GOSALES data source is selected, and then click 

Next. 

2. In the list of objects, expand GOSALES > Tables. 

3. Select the following initial tables: 

ORDER_DETAILS 

ORDERJHEADER 

ORDER_METHOD 

PRODUCT 

PRODU CT_LINE 

PRODU CT_NAME_LOOKUP 

PRODU CT_TYPE 

4. Click Next, leave the defaults for the Generate Relationship criteria, and then 
click Import. 

The import process begins, and then a message appears summarizing the seven 
query subjects and six relationships that were imported. 

5. Click Finish. 
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PROJECT 



6. In the Project Viewer pane, expand the gosales namespace. 



The results appear as follows: 



Project Viewer 



GO Operational 

GO Operational Model 



□ g Q Foundation Ubjects View 






gosales 



$■ 

0- 

$■ 

0 - 

0 - 

a- 



□ x 



ORDER. DETAILS 
OFlDER_HEADEFl 
ORDER.. METHOD 
PRODUCT 
PRODUCT_LINE 
PRODUCT. NAM E_L00 KLIP 
PRODUCT TYPE 



The namespace now contains a list of data source query subjects, which 
represent each of the tables that were imported from the relational database. 

7. Expand the Data Sources folder. 



The results appear as follows: 

- [g] Data Sources 
0 GOSALES 

This folder now contains the GOSALES data source, which you specified 
during the import. This data source is now associated with the objects you just 
imported. 

8. Select the GOSALES data source. 



9. In the Properties pane, ensure the Query Processing property is set to 

Limited Local. 



This will allow IBM Cognos to process operations locally that are not supported 
by the data source. 
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Task 5. Test basic data access. 



1. In the Project Viewer, expand PRODUCT. 



The results appear as follows: 





PRODUCT 

Qg) P ROD UCT_N UMBER 



DU BAS E_PRODUCT_N UMBER 
[g! I NTRO D UCTIO N_D ATE 
[]£! DISCONTIN UED_D ATE 
[g| PROD UCT_TYP E_CO D E 
[1 PROD UCT_CO UO R_CO D E 



[ffl PRODUCT_SIZE_CODE 
[HI PRODUCTS RAN D_CODE 
|| PROD UCTIO N_COST 



OH GROSS_MARGIN 




PRODUCTJMAGE 



Here you see all the query items for this query subject. These query items 
represent the columns found in the data source table. 

2. Double-click PRODUCT. 

The SQL tab shows "Select * from [GOS ALES] .PRODUCT". This SQL 
statement defines the scope of the PRODUCT query subject. It is used to 
generate your query item list as well as the mn time SQL when you create a 
query using the query items. The [GOS ALES] portion is the name of the data 
source the query subject is associated with. 
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3. Click the Test tab, and then click Test Sample in the bottom right comer. 
The results appear as follows: 



Ques j y Subject Definition - PRODUCT 



la x 



SQL J Calculations ] Filters j Determinants Test | Query Information | 



iAyta S uni 



T est results 




PRODUCTS UMBER 


BAS E JP'Fi 0 D U CT_ N IJ M B E FI 


INTRODUCTION DATE 


[ 




1110 


1 


Feb 15.. 1995 12; 00: 00 AM 






21 1 0 


2 


Feb 15.. 1995 12:00:00 AM 






31 1 0 


3 


Feb 15,1 995 12:00:00 AM 






4110 


4 


Feb 15.. 1995 12:00:00 AM 






5110 


5 


Feb 15.. 1995 12; 00: 00 AM 






6110 


6 


Mar 5.. 1997 12:00:00 AM 






7110 


7 


Feb 15.. 1995 12:00:00 AM 






81 1 0 


8 


Mar 5, 1997 12:00:00 AM 






9110 


9 


Mar 5.. 1997 12:00:00 AM 


5 




10110 


10 


Feb 15.. 1995 12:00:00 AM 


l 




11110 




Feb 15.. 1995 12:00:00 AM 






12110 


12 


Mar 5, 1997 12:00:00 AM 


3 




1 31 1 0 


13 


Feb 15.. 1995 12:00:00A.M 


5 

v 




14110 


14 


Mar 5, 1997 12:00:00 AM 






_ 












<1 




gji 



m 



111 



£> lest Sample ^4 Total Flows [E] Options 




OK 



Cancel 



Help 



You see a sample of the first 25 records, confirming your access to the data. 
You can increase or decrease the amount of rows retrieved in the Options 
located in the lower right corner. If you want to know how many rows of data 
there are in the data source table, click Total Rows. 
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4. Click the Query Information tab. 
The results appear as follows: 




You see the full SQL in two formats: the generic Cognos syntax (Cognos SQL) 
and the syntax specific to the data source (Native SQL). This is the SQL 
generated at mn time and passed to the data source. The SQL generated here is 
based on the SQL defined on the SQL tab of the data source query subject. 

5. Click OK to close the Query Subject Definition dialog box. 
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Task 6. Change SQL generation settings and specify a 

function list. 

1. From the Project menu, click Edit Governors. 

These properties govern the queries that are generated based on the model. 
These will be described in more detail later in the course. 

2. Clear the Use WITH clause when generating SQL checkbox, and then click 

OK 

You will now specify a function list specific to the data source you are using in 
this model. These functions are specific to the database vendor and allow 
authors and modelers to perform advanced tasks with the data sources such as 
date and string manipulations. 

Specifying a function set per data source will limit the function sets that are 
published to IBM Cognos with a package. By default, all supported function 
sets are published with a package. Publishing only the required functions sets 
can reduce the package size and prevent confusion where authors may 
inadvertently use functions from another data source. 

3. From the Project menu, click Project Function List. 
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4. Select Set function list based on the data source type, and then in the 
Function set column beside GOSALES, select DB2. 

The results appear as follows: 




Now, by default, only DB2 functions will be published with a package in this 
project. 

5. Click OK 

Task 7. Test multiple query subject data access. 

1 . If necessary, in the center pane click Diagram. 

2. Close the Properties and Tools panes to view more of the center pane 
diagram, and then double-click the gosales box to focus on the gosales 
namespace. 
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Select the Diagram tab and, if necessary, on the toolbar, click Fit All 





The results appear as follows: 




Note: Here you can see all the relationships generated by Framework Manager 
during import. These relationships allow IBM Cognos to generate the 
appropriate SQL at mn time to join query items from the different query 
subjects. You can adjust the settings of the diagram from the Diagram 
menu. There are several options. For example, you can choose to view 
cardinalities in Merise notation (as seen in the screen capture) or 
Crowsfeet notation (provides a pictorial representation of the 
relationship). Take a moment to explore the options. 
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4. In the diagram, select the following query items: 



Query Subject 


Query Item 


PRODU CT_LINE 


PRODU CT_LINE_EN 


PRODUCTTYPE 


PRODU CT_TYPE_EN 


PRODUCT 


PRODU CT_NUMBER 


ORDER_DETAILS 


QUANTITY 

UNIT_SALE_PRICE 



5. Right-click one of the selected items, click Test, and then click Test Sample. 

A sample 25-row report confirms that you can access the data. Note the values 
for quantity and unit sale price. 

6. In the top right corner of the window, click Auto Sum, and then click Test 
Sample again. 

The results appear as follows: 

v Auto Surd 



T est results 



PRODUCT_LINE_EN 


PR0DUiCT_TYPE EN 


PRODUCT_NUMBER 


QUANTITY 


UNIT JBALE, PRICE 


Camping Equipment 


Cooking Gear 


1110 


4300828 


6832.88 


Camping Equipment 


Cooking Gear 


2110 


865723 


14111.63 


Camping Equipment 


Cooking Gear 


31 1 0 


866668 


26852.57 


Camping Equipment 


Cookina Gear 


4110 


1 81 21 23 


3866 



This time, you see that QUANTITY has been summed. UNIT_SALE_PRICE 
has also been summed, which we will correct later. 

7. Close the Test Results dialog box, and then save the project. 

Results: 

You started to develop the model that will support the business 
requirements of report and ad hoc query authors. You created a 
project, structured it, and imported baseline metadata. 
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Demo 3: Publish a Package 



Purpose: 

Now that you have a baseline project, you will verify its reporting 
capabilities by publishing a package and using it to view data in 
Business Insight Advanced. 



Components: Framework Manager, Business Insight Advanced 



Project: 



GO Operational 



Package: 



GO Operational 



Task 1 . Create and publish a package. 



1 . In the Project Viewer pane, right-click Packages, point to Create, and then 
click Package. 

The Create Package Wizard appears. Since the package will include the full 
contents of the project, you will give it the same name as the project. 

2. In the Name box, type GO Operational, and then click Next. 

3. Expand Foundation Objects View and gosales. 



The results appear as follows: 



From the project 









LIE 


l 


liO Uperational Model 






d 




Foundation Objects View 




±1 


gosales 



a- 

a- 



/ t 




✓ t 



0 

$ 
a 



T 



eh*/ 



□ FI DER_DE TAILS 

ORDEFi_HEADEFi 

ORDER. METHOD 

PRODUCT 

PRODUCT_LINE 

F'R0DUCTJJAME_L00KUP 

PRODUCT TYPE 



This is where you can restrict the package contents to a subset of your model. 
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4. Click Next. 

The results appear as follows: 

Select the set of functions that will be available in this package. 



Available function sets: Selected function sets: 



Aster Data 




DB2 


Greenplum 

Informix 






MS Access 

MySQL 

Netezza 

Oracle 

F'araccel 






Postgres 

Redbrick 


.si 




SAPBW 
SQLServer 
Sybase 
T eradata 
Vertica 







Here you have the option to specify which function sets get published with the 
package. Since you associated SQL Server functions with the GOSALES data 
source, it is by default, the only function set currendy selected. 

5. Click Finish. 

A dialog box appears indicating that the package was created successfully, and 
prompts you to open the Publish Package wizard. Publishing places a package 
in the IBM Cognos Content Store, where it can be accessed from IBM Cognos 
Connection and the IBM Cognos Studios. 

6. Click Yes. 

IBM Cognos allows you to maintain multiple versions of a package. This is 
done to prevent breaking reports when re-publishing a package with changes 
that affect the reports. You will not use this feature for most of this course. 

7. Clear the Enable model versioning check box, accept the remaining defaults, 
and then click Next. 
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8. On the Add Security page, click Next, and then click Publish. 

The package is verified by default before the package is published. 

Once verified and published, a message appears within the wizard indicating 
that the package was successfully published. 

9. Click Finish to close the wizard, and then save the project. 

Task 2. View the package in Business Insight Advanced. 

1 . Open Internet Explorer. 

2. In the Address box, type http: / /localhost:88/ ibmcognos, and then press 
Enter. 

The Log on page appears. 

3. Log on as admin/Educationl!. 

The Welcome page of IBM Cognos Connection appears. 

4. Under My Actions, click Author business reports. 

The Select a package page appears, and prompts you to choose a package to use 
in creating the report. Note that the GO Operational model you just published 
is available. 

5. Click GO Operational. 

6. In the Welcome dialog, click Create new. 

7. In the New dialog, click List and then click OK. 

Business Insight Advanced appears in the browser. Under Insertable Objects 
on the right side of the page, you can see that the GO Operational root 
namespace and the Foundation Objects View namespace appear. These were 
the objects you specified in the Publish Package wizard in Framework Manager. 

8. Expand Foundation Objects View, and then gosales. 

The query subjects appear and are available to an ad hoc query author for 
creating a report. 
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Task 3. Create a report. 

1. In the gosales namespace, expand the PRODUCT_LINE query subject, and 
then double-click the PRODUCT_LINE_EN query item. 

2. Repeat step 1 to add the following items: 



Query Subject 


Query Item 


PRODUCTTYPE 


PRODU CT_TYPE_EN 


PRODUCT 


PRODU CT_NUMBER 


ORDER_DETAILS 


QUANTITY 

UNIT_SALE_PRICE 



The results appear as follows: 



PRODU CT_LNE_EN 


PRO 0 U CT_TYPE_E N 


PRO D U CT_N U M BE R 


QUANTITY 


UNIT_SALE_PRICE 


Camping Equipment 


Cooking Gear 


1 1 1 0 


4 , 303,323 


0 , 332.33 


Camping Equipment 


Cooking Gear 


2110 


365,723 


14 , 111.03 


Camping Equipment 


Cooking Gear 


3110 


300,003 


20 , 352.57 


Camping Equipment 


Cooking Gear 


4110 


1 , 312,123 


3,300 


Camping Equipment 


Cooking Gear 


5110 


313,730 


02 , 344.0 


: a- J. 


1-:-: - 


.H A Q 


J J -■ A 


a J j a r- r, r. 



You have successfully created the same ad hoc query you tested in Framework 
Manager earlier. Here the values are automatically sorted and summarized. 

3. Close Internet Explorer, do not save changes, and leave Framework 
Manager open. 

Results: 

You have verified the reporting capabilities of your new project by 
publishing a package from it and using the package to view data in 
Business Insight Advanced. 
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Business Analytics 



Import Additional Metadata 

Relationships are created for you during the imped of yotr data. Select the criteria to use to 
generate relationships. 

Select at least one criteria to detect and generate reidkinshfH. 

17 Use primary and foreign keys 

Use matching query item names that represent uniquely indexed columns 
f~ Use matching query item names 

Select between which set of objects you want to detect and generate relationships. 
Between the imported query subjects 

Between each imported query subject and all ejoslmg quay subjects in the mode! 

(*" Both 

Indicate how you want to generate relationships between the imported query subjects. 
Outer joins: 

(* Convert to inner join (I.ji) 

Create outer join (0..n) 

Granularity: 

17 Fact detection enabled (1. jt, B.ji) 



Cognos 

software 

©2010 IBM Corporation 



When importing additional metadata from the same data source or another compatible 
data source (primary and foreign keys match), select Both in the wizard. This generates 
relationships among the objects being imported as well as the existing objects in the 
model. By selecting this option, you will not need to create the relationships manually 
after import. 
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Business Analytics 



Requirements Review 



Recommendation #1 




Cognos 

software 
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In the next demo, you will import metadata to satisfy the highlighted reporting 
requirement above. The database tables used to satisfy this requirement are as follows: 



Reporting Requirement 


Database Tables 


Staff by Location 


BRANCH 

COUNTRY 

SALES_REGION 

EMPLOYEE 

EMPLOYEE_HISTORY 

POSmON_LOOKUP 
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Demo 4: Extend the Model to Add Staff Location Metadata 



Purpose: 

Now that you have an understanding of the Framework Manager 
modeling environment and process, you can extend your model to 
support additional business requirements from report and ad hoc 
query authors, namely reporting sales by sales staff location. 



Component: Framework Manager 

Project: GO Operational 

Task 1. Import additional metadata. 

1 . In the Project Viewer, right-click the gosales namespace, and then click Run 

Metadata Wizard. 

You will import more items from the GOS ALE S database. 

2. Ensure that Data Sources is selected, and then click Next. 

3. Ensure that GOSALES is selected, and then click Next. 

4. In the list of objects, expand GOSALES and Tables, and then select the 
following tables: 

• BRANCH 

• COUNTRY 

• SALESJREGION 

5. Expand GOSALESHR and Tables, and then select the following tables: 

• EMPLOYEE 

• EMPLOYEEJHISTORY 

• POSITION_LOOKUP. 

6. Click Next. 
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7. On the Generate Relationships page, click the Both radio button as shown 
below. 

Select between which set of objects you want to detect and generate relationships. 

C Between the imported query subjects 

C Between each imported query subject and all existing query subjects in the model 
ff Both 

You want to generate relations among the new query subjects as well as 
between the new and existing query subjects. This will prevent you from having 
to manually create the relationships after the import. 

8. Click Import. 

The import process begins, and then a message appears summarizing the count 
of objects that were imported. 

9. Click Finish. 

The gosales namespace now contains a list of query subjects, which represent 
each of the tables that were imported from the relational database. 

10. From the View menu, click Properties. 

11. If necessary, expand the Data Sources folder, and then click GOSALES1. 

The second data source, GOSALES 1, was created for the query subjects you 
selected from the second schema, gosaleshr. 

Task 2. Rearrange the diagram. 



1 . 

2 . 

3. 



From the Diagram menu, and then click diagram Settings 
Under Level of Details, deselect Query Items, and then click OK. 



Close the Properties pane, ensure Diagram is selected and then, from the 
toolbar, click Auto Layout 
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4. Beside Layout Style, ensure that Standard is selected, and then set both 
Horizontal and Vertical distances to 30, click Apply, and then click Close. 



The results appear as follows: 




You can now view all the items imported into your project in a simplified way 
by reducing the detail and adjusting the space between the objects. 



If you were importing a star schema structure, you would select the Star option 
under Layout Style to set fact query subjects as focal points with their related 
dimensions surrounding them. 

You will identify and correct any missing relationships in the next module. 

Results: 

You extended the model to support additional business 
requirements for report and ad hoc query authors by importing 
metadata to support sales staff location queries. 
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Business Analytics 



Requirements Review 



Recommendation #1 




Cognos 

software 
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In the next workshop, you will import metadata to satisfy the highlighted reporting 
requirement above. The database tables used to satisfy this requirement are as follows: 



Reporting Requirement 


Database Tables 


Retailer 


RETAILER 
RET AILER_SITE 
RETAILER_TYPE 
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Workshop 1 : Enhance the Model to Add Retailer Data 



Business analysts at The Great Outdoors Company have additional reporting 
requirements that need to be met. They want to report on sales by retailer. 

Retailer information is supported by the following tables in the data source: 

• RETAILER 

• RETAILER_SITE 

• RETAILERTYPE 

Import these query subjects, and then rearrange the diagram to show all query subjects. 

Use the Test tool in Framework Manager to verify that you can report on the new data. 

For more detailed information outlined as tasks, see the Task Table section on the next 
page. 

For the final query results, see the Workshop Results section that follows the Task 
Table section. 
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Workshop 1 : Task Table 



Task 


Where to Work 


Hints 


1 . Import metadata. 


From gosales 
namespace, Run 
Metadata Wizard 


• Data Source = GOSALES 

• Schema = GOSALESRT 

• Tables = RETAILER, 
RETAILER_SITE, RET AILER_TYPE 

• Generate relationships: Both 


2. Organize the 
entity relationship 
diagram. 


Center pane, 
Diagram setting 


• Use Auto Layout with distances of 30 


3. Test that you 
have access to the 
new data. 


Project Viewer 


• Select RETAILER. COMP AN Y_NAME 
and RETAILER_SITE.RTL_CITY, 

RET AILER_TYPE.TYPE_N AME_EN 

• Right-click one of the selected items, click 
Test, and then click Test Sample 


4. Save and close 
the project. 


File menu 


• Save 

• Close the project 
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Workshop 1: Workshop Results 



The resulting diagram should have the same query subjects and relationships as the 
following: 



■JF 






1 


Ln 














ORDER METHOD 






1..1 



ORDERJHEADER 

' 







BRANCH 



X 



X 



X 



X 



X 



1..1 



RETAILER 



g 1 PRODUCT. NAME_L00KUP 



ORDER DETAILS 



i.nl.1 



PRODUCT 



ill 

1 j 



1 ..n 
1..1 



PRODUCT TYPE 






1 .in 



EMPLOYEE 



1..1 


jg E M PL 0YEE_HI STORY 


1..1 


XI 






" ' — 1 — 



1..n 



l.n f Q 0POSITION_LOOKUP 



1..1 



COUNTRY 



i i 



1 :. n1 ..1 



SALES REGION 




RETAILER 



Ut .1 



RETAILER 



PRODUCT LINE 
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Business Analytics =§: 

Summary 

■ You should now be able to: 

■ follow the IBM Cognos and Framework Manager 
workflow processes 

■ define a project and its structure 

■ describe the Framework Manager environment 

■ create a baseline project 

■ enhance the model with additional metadata 

Cognos 

software 

©2010 IBM Corporation 
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Prepare Reusable Metadata 



IBM Cog nos BI 




Business Analytics 
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Business Analytics 

Objectives 

■ At the end of this module, you should be able to: 

■ verify relationships and query item properties 

■ ensure efficient filters by configuring prompt 
properties 






Oognos* 

software 
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Business Analytics 



Framework Manager Workflow 



Framework Manager 



Create 

Project 




Import 

Metadata 



Prepare 

Metadata 



Publish 



Set 

Security 



Model 

Metadata for 
Reporting 



I 



Create and 
Manage 
Packages 



Data 

Sources 



Content 

Store 



Report Studio 
Query Studio 
Analysis Studio 
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The Prepare Metadata phase involves verifying and modifying relationships and object 
properties and customizing metadata for mn time. 

These changes can be made either to the original data source query subjects (in the 
Foundation Objects View), or to the model query subjects (such as those you will 
create later in the course). Changes to the original data source query subjects are 
reusable. These query subjects may later be used in several different model query 
subjects, each of which will inherit the same changes. However, if you do not intend 
for a modification to be universal, then it should be made in the specific model query 
subjects that require that change. 
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Business Analytics 

Goals of a Data Modeler 



Data modelers have 3 main 
goals: 

■ Accuracy: Reports must 
contain accurate data. 

This is the most essential 
goal. 

■ Usability: Packages must be 
understandable by report 
authors and other users. 

■ Performance: Reports must 
take the least system 
resources possible. 



Accuracy 




Usability Performance 

Usability and performance offer a 
trade-off. 

Modelers can gain usability by 
sacrificing performance and vice-versa. 

Cognos, 

software 

©2010 IBM Corporation 



The goals of the data modeling process can be summarized in three categories: 

• Accuracy: If the packages created from a model do not produce reports with 
accurate data, the model is inherently flawed and must be repaired. 

• Usability: The packages produced from a model must be understandable by those 
who will use the packages to create reports and perform analysis. 

• Performance: Data should be retrievable in a reasonable amount of time. 
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Business Analytics 

Verify Relationships 

■ Ensure your model has all required relationships after 
import. 

■ Ensure the join cardinality between query subjects 
meet your needs 

■ 0..n - zero occurrences to multiple occurrences 

■ l..n - one occurrence to multiple occurrences 

■ 0..1 - zero occurrences to one occurrence 

■ 1..1 - must have one occurrence 

Cognos* 

software 

©2010 IBM Corporation 



Relationships are maintained in the Object Diagram or Context Explorer. 

When verifying your relationships, you must ensure that the appropriate relationships 
exist to meet your reporting needs and you must decide if you require optional or 
mandatory cardinalities. Optional cardinalities require more processing, but may be 
needed to return the desired results. 

Optional cardinality is represented by a 0 as seen in the 0..n and 0..1 examples. 
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Business Analytics 



Mandatory Cardinality Example 



Product Type Table 



Product Line Table 


PL# 


PT# 


PT_Desc 


PL# 


Plods 


1..1 


1 


100 


Aviator 


1 


Sunglasses 


" 0 


1 


200 


High Fashion 


2 


Razors 
















1 


300 


Prescription 








1 


400 


Children 






PL# 


Plods 


PT# 


PT_Desc 


1 


Sunglasses 


100 


Aviator 


1 


Sunglasses 


200 


High Fashion 


1 


Sunglasses 


300 


Prescription 


1 


Sunglasses 


400 


Children 



Cognos 

software 

©2010 IBM Corporation 



In the slide example, only rows in which the join condition is met are returned (where 
the product line number exists in both tables) . The Razors product line is omitted from 
the record set. 
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Business Analytics 

Optional Cardinality Example 



Product Type Table 




With the cardinality set to 0..n on the Product Type table, all rows from the Product 
Line table are returned since a mandatory match in the Product Line table is not 
required. The Razors product line now appears in the record set. 
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Purpose: 

To meet reporting requirements, you will verify your relationships to 
ensure none are missing and that the cardinality is set accordingly. 

Component: Framework Manager 

Project: GO Operational 

Task 1 . Examine relationships. 

1. In Framework Manager, close any open projects, and then open the GO 

Operational project located at C:\Edcognos\B5152\CBIFM-Start Files\ 
Module 5\GO Operational. 

This is the baseline project created in the previous module. 

2. Log in as User ID admin, and Password Educationl!, if prompted. 

3. In the middle pane, click Diagram, and then double-click the gosales box to 
give it focus in the diagram. 

You will increase the level of detail in the diagram to include query items. 

4. From the Diagram menu, click Diagram settings, select Query Items, and 
then click OK 

5. Using the Auto Layout dialog box, set the horizontal and vertical distance to 
25 to increase the distance between objects. 
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6 . 
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Click the relationship between ORDER_DETAILS and PRODUCT. 
The results appear as follows: 















a ORDER DETAILS * 




a PRODUCT 


¥ 






ORDER DETAIL CODE 




PRODUCT NUMBER 








ORDER NUMBER 




BASE PRODUCT NUMBER 








SHIP DATE 




INTRODUCTION DATE 




A 




PRODUCT NUMBER 




DISCONTINUED DATE 




1 




PROMOTION CODE 




nl.,1 


PRODUCT TYFb CODE 








QUANTITY 


1 .. 


PRODUCT COLOR CODE 








UNIT COST 






PRODUCT SIZE CODE 




1 




UNIT PRICE 






PRODUCT BRAND CODE 








UNIT SALE PRICE 






PRODUCTION COST 






/ In 




GROSS MARGIN 


□ 





The relationship line turns red and the query items used in the join are 
highlighted, in this case PRODU CT_NUMBER. 
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7. Double-click the relationship. 
The results appear as follows: 




Here you can configure the relationship as required. You can change the query 
items used in the join, the cardinality settings, the operator, or edit the 
expression to create a more complex join. 
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8. Click the Relationship SQL tab. 



The results appear as follows: 



Relationship Definition - PRODUCT <— > ORDER_DET AILS 



Relationship Expression Fi elationship SQL | 
Sample SQL statement using the relationship: 



select 



PR D D U CT . PR 0 D U CT_N U M B E R as PR 0 D U CT_N U M B E R . 

PR 0 D U CT . BAS E_PR 0 D U CT_N U M B E R as BAS E_PR 0 D U CT N U M B E R . 
PR D D U CT . I N T R 0 D U CT 1 0 N DAT E as I N T R 0 D U CT 1 0 N_DAT E . 

PR D D U CT . D I S CD N T I N IJ E D DAT E as D I S CD N T I N U E D DAT E . 

PR 0 D U CT . PR 0 D U CT_T YPE CO D E as PR 0 D U CT_TYPE_C0 D E .. 

PR 0 D U CT . PFI 0 D U CTJJI LO R_C0 D E as PR D D U CT CO LO R_C0 D E . 

PR D D U CT . PR 0 D U CT_S IZE_C0 D E as PR 0 D U CT_S IZE_C0 D E , 

PRO DUCT. PRO DUCT BRAND CODE as PRODUCT J: RAND CODE, 

PR 0 D U CT . PR 0 D U CT 1 0 N CO S T as PR 0 D U CT 1 0 N CO S T . 

PR 0 D U CT . G R 0 S S MAR G I N as G R 0 S S MAR G I N . 

PR 0 D U CT . PR 0 D U CT J MAG E as PR 0 D U CT J MAG E . 

0 R D E R D E TAJ LS . 0 R D E R D E TAJ L JCD D E as 0 R D E R_D E TAJ L_C0 D E . 
ORDER DETAILS. ORDER_NUMBER as ORDER J-JUMBER. 

0 R D E R D E TAJ LS .SHI P_ DAT E as S H I P_DAT E . 

ORDER DETAILS. PRODUCT NUMBER as PRODUCT NUMBER'D 



n n r, r n nrT:n r nnni jnTinki rnnr 



mn n l j n t i n k i r-n r. r 



d 



T est 



Rows 



Here you can view the SQL that is generated to join these two query subjects 
together and can test the items returned by the join. 

9. Click Cancel. 



10. In the bottom right corner of the diagram, click Diagram Overview 

1 1 . Drag the red viewing window to view all parts of the diagram. 

This feature is useful when dealing with larger models. 



You can see that all query subjects are linked to at least one other query subject, 
and that most relationships are one-to-many. You will examine one relationship 
in detail. 



12. Close the Diagram Overview window. 

It is recommended that you examine each relationship to verify that it is the 
relationship required for reporting purposes (with the appropriate cardinality) 
and make note of any missing relationships, where issues might occur, or items 
may need to be revisited. 
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Task 2. Identify missing relationships. 

1 . Examine the portion of the diagram below: 




EMPLOYEE is joined to EMPLO YEE_HIST ORY in a one-to-many 
relationship, allowing you to report on past positions. You will test this in the 
next task. BRANCH is also joined to EMPLO YEE_HISTORY in a one-to- 
many relationship. In this scenario EMPLO YEE_HISTORY is acting as a 
"bridge" table in a many-to-many relationship between BRANCH and 
EMPLOYEE. An employee may have worked in several branches and a branch 
may have several employees. 

BRANCH has a relationship to ORDER_HEADER that indicates which 
branch made a sale. EMPLOYEE does not have a relationship to 
ORDER_HEADER. In this state, you cannot report on sales by staff, which is 
one of the requirements. EMPLOYEE needs a relationship to 
ORDER_HEADER. 

In speaking with the database modeler, you discover that the relationship 
between the two objects should be EMPLO YEE.EMPLOYEE_C ODE to 
ORDER_HEADER.SALES_STAFF_CODE. The names are different, but 
they do in fact represent the same information. 



©2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 
or translated into another language without a legal license agreement from IBM Corporation. 



5-13 



IBM COGNOS FRAMEWORK MANAGER: DESIGN METADATA MODELS (V10.1) 



2. In the diagram, Ctrl+click EMPLOYEE.EMPLOYEE_CODE and 
ORDER_HEADER.SALES_STAFF_CODE. 

3. Right-click one of the selected items, point to Create, and then click 

Relationship. 

The results appear as follows: 




A relationship with the selected query items and appropriate cardinality is created. 

Note: When creating a relationship with this method, the query item selected 
first will be on the 1..1 side and the second query item will be on the l..n 
side. 
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4. Click OK 

The results appear as follows: 





7 




/ 


J 




/ 


t..i A 



ORDER HEADER 



ORDER NUMBER 
RETAILER NAME 
RETAILER NAME MB 
RETAILER SITE CODE 
RETAILER CONTACT CODE 
SALES STAFF CODE 
SALES BRANCH CODE 
ORDER DATE 
ORDER CLOSE DATE 
ORDER METHOD CODE 



1.1 



BRANCH 



BRANCH CODE 
ADDRESS! 
ADDRESS! MB 
ADDRESS2 
ADDRESS2 MB 
CITY 
CITY MB 
PROV STATE 
FROV STATE MB 
POSTAL ZONE 




¥ 




EMPLOYEE HISTORY 



EMPLOYEE HISTORY CODE 
EMPLOYEE HISTORY PARENT 
EMPLOYEE CODE 
RECORD START DATE 
RECORD END DATE 

POSITION CODE 

POSITION START DATE 
MANAGER CODE 
MANAGER 
MANAGER MB 




1..n 



EMPLOYEE 



¥ 



EMPLOYEE CODE 
FIRST NAME 
FIRST NAME MB 
LAST NAME 
LAST NAME MB 
DATE HIRED 
TERMINATION DATE 
TERMINATION CODE 
BIRTH DATE 
GENDER CODE 




POSITION LOOKUP 






POSITION CODE 
POSITION EN 
POSITION DE 
POSITION FR 
POSITION JA 
POSITION CS 
POSITION DA 
POSITION EL 
POSITION ES 
POSITION FI 



At this point, you are just ensuring that all required relationships are in place. 
Refining the model for presentation and predictable results will occur later in 
the modeling process. 
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Task 4. Test relationships. 

You will now test one relationship to help you understand the data as well as test the 
new relationship you just created. 

1 . In the diagram, scroll down in EMPLOYEEJHISTORY until you can see 



BRANCH_CODE, and then select the following query items: 



Query Subject 


Query Item 


EMPLOYEE 


FIRST_NAME 

LAST_NAME 


EMPLOYEE_HISTORY 


RE C O RD_ST ART_D ATE 
RECORD_END_DATE 
MANAGER 
BRANCH_CODE 


POSmON_LOOKUP 


POSITION_EN 



2. Right-click one of the selected items, click Test, and then click Test Sample. 

3. Scroll down until you see Maria Iacobucci. 



The results appear as follows: 



Test results 






FIRSTJ-JAME 


LAST_NAME 


R E CO R D_S T AR T_D AT E 


RECORD_END_DATE 




Silvano 


Allessori 


Jun 27.. 2006 12:00:00 AM 






Maria 


Iacobucci 


Mar 25.. 2002 12:00:00 AM 


Apr 4,2005 12:00:00 AM 




M aria 


Iacobucci 


Apr 5,2005 12:00:00 AM 






Alessandra 


T orta 


Dec 15, 2003 12:00:00 AM 





You can see that Maria changed managers (perhaps moving to a different part 
of the organization, but within the same branch) . 
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4. Click Close. 

You will now test the new relationship between EMPLOYEE and 
ORDER_HEADER. 

5. In the diagram, test the following query items: 



Query Subject 


Query Item 


EMPLOYEE 


FIRSTJNAME 

LAST_NAME 

EMPLOYEE_CODE 


ORDER_HEADER 


SALES_STAFF_CODE 


ORDER_DETAILS 


QUANTITY 



The results appear as follows: 







Test results 








FI Fl S T_N AM E 


LASTJJAME 


EMPLOYEE .CODE 


SALE S_STAFF„ CODE 


QUANT STY 




Margaret 


Lewiston 


1 0OGE! 


1 0068 


68 




Rhonda 


Cummings 


1 0Q.56 


1 0056 


27 




Rhonda 


Cummings 


1 0056 


1 0056 


46 




R honda 


Cummings 


1 0056 


1 0056 


43 




R honda 


Cummings 


1 0056 


1 0056 


137 




Rhonda 


Cummings 


1 0056 


1 0056 


48 




R honda 


Cummings 


1 0056 


1 0056 


820 



You can see that the EMPLOYEE_CODE values and 
SALES_STAFF_CODE values do match. If you would like to see how many 
items an employee sold overall, you can test with Auto Sum enabled. 



©2003, 2010, IBM Corporation 5-17 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 
or translated into another language without a legal license agreement from IBM Corporation. 



IBM COGNOS FRAMEWORK MANAGER: DESIGN METADATA MODELS (V10.1) 

6. Select Auto Sum, and then click Test Sample again. 

The results appear as follows: 



v- Auto Surd 



1 est results 





FI F! S T_N AM E 


LAST .NAME 


EMPLOYEE j::0DE 


SALE S __S T A,FF Jl:0 D E 


QUANTITY 




Aaltje 


Hansen 


1 0359 


1 01 00025 


470937 




Abram 


Ruiz 


1 0237 


1 223321 5 


962052 




Adda 


Heijman 


1 0360 


9531 200 


471 956 




Adriaantje 


H aanraads 


1 0361 


9900099 


535961 




Agatha 


Reyes 


10307 


1 1 23463 


610229 



Quantity is now summed for each employee. The relationship is working as 
expected. However, notice the SALES_STAFF_CODE value. It seems to have 
been summed as well. This is because it was set as an integer during import. 
You will examine and fix this issue in the next demo. 

7. Click Close, click Save, and keep Framework Manager open for the next 
demo. 



Results: 

To meet reporting requirements, you verified your relationships and 
added a missing relationship. 
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Business Analytics 

Verify and Modify Query Item Properties 

Recommendation #3 

■ After import, verify that the metadata represents 
the business needs. 

- Should Usage for Manager_Code = Identifier, 
Fact, or Attribute? 

- Should Regular Aggregate for Unit_Price = 

SUM? 

- Should a prompt on Country Name retrieve 
through Country Code? 

Coanos* 

software 

©2010 IBM Corporation 



Facts are numeric or time-interval, non-indexed columns. Identifiers are key, index, 
date, datetime, or any indexed columns. Attributes are typically strings. 

The Regular Aggregate property for numeric facts (measures) defaults to SUM, which 
is correct for most measures (such as REVENUE and QUANTITY). However a 
report identifying four tents sold to a customer would probably not display the sum of 
their prices, but instead the average. 

Take advantage of Prompt properties to improve performance by causing automatic 
retrieval through indexes. 
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Demo 2: Verify and Modify Query Item Properties 



Purpose: 

To meet reporting requirements, you will verify that important query 
item properties, such as Usage and Regular Aggregate, are correct. 
You will also ensure efficient queries using filters by configuring 
query items to use an indexed key value rather than a non-indexed 
string value in the filter. 



Components: 

Project: 

Package: 



Framework Manager, Query Studio, Report Studio 
GO Operational 
GO Operational 



Task 1 . Verify Usage property settings. 



1 . 

2 . 



If necessary, from the View menu, click Properties to view the Properties 
pane. 



In the Project Viewer, expand ORDER_HEADER, and then click 

ORDERJNUMBER. 



Both the query item icon m and the Usage property field tell us that 



ORDER_NUMBER is an identifier, and were identified as such during import 
since this is the primary key in the database table. 
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3. Click SALES STAFF CODE. 



4. 



In comparison, S ALE S_ST AFF_CODE has a measure icon (also known as a 

Fact) E and its Usage property is set to Fact. This was specified during the 
import because it is a non-indexed numeric field in the database. You know that 
this query item is not a measure. It is used for associating several employees to 
an order. You will set this query item's Usage property to Attribute. If you know 
that any item would be used in relationships or that report authors would filter 
on an item regularly, you would ask the database administrator to index the field 
in the database. At that point you would set the Usage property to Identifier. 

For now, you will set SALES_STAFF_CODE as Attribute to indicate to 
yourself and other modelers that this integer field is not indexed in the database. 

In the Properties pane, click the Usage property, and then select Attribute 
from the list. 



You will now change multiple properties at once to correct other items 
incorrecdy set as facts. 

5. Under ORDER_HEADER, select the following items: 

• RETAILER_SITE_CODE_ 

• RETAILER_CONTACT_CODE 

• sales_branch_code 

6. In the Properties pane, in the RETAILER_SITE_CODE row, scroll to the 
right, click Fact below the Usage heading, and then select Attribute from the 
list. 



7. Drag the small black arrow beneath the value downward to change the values 
to Attribute for the other two query items. 
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Task 2. Use Bulk Replace to change property settings. 



Rather than go through each query subject and manually change the Usage setting for 
codes from Fact to Attribute, you can use the Search tool to perform bulk changes. 

1. If necessary, from the View menu, click Tools. 

2. In the Tools pane, click the Search tab, and then in the Search string box, 
type _CODE. 



3 . 

4 . 



Beside the Search button, click 






to see additional search options. 



Select the following configuration: 



Search string: 



I) Subset 



|_C0DE 


Search & 


Condition: 




I contains 


.d 






Search in: 




‘S gosales 




□ass: 




Query Item 





Property: 
pbject Name 



- 



This will confine your search to the gosales namespace, only look at query 
items, and only look at name properties containing the string _CODE. 
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5. Click Search, and then, if necessary, resize the Tools pane to view the results. 
The results appear as follows: 







Dbjed 


Property 


Value 


D 

D 

r 


*|ORDER_DETAILCODE GO Operational Model \ ... 

It P RO MOTIO N_CO DE GO Operational Model \ . . . 

j RETAILER SITE CODE GO Operational Model \ ... 

j RETAILER CONTACT CODE GO Operational Model \ ... 

j SALES STAFF CODE GO Operational Model \ ... 

CT1 C.I-. i cc id d * Mr u rnn: n m-.-i-i 


0 R D ER_D ETAI L_CO D E 
P RO MGTIO N_CD D E 
R ETAI LER_S ITE_CO D E 
R ET Al LER_CO NTACT_. . . 
SALES_STAFF_CODE 

cai cc deajjqli rnnc 



You will search a subset of this result set to display only items whose Usage 
property is set to Fact. 

6. Select the Subset check box, in the Search string box, type fact, and then 
change the Property selection to Usage. 

The results appear as follows: 



Search string: 42 found 






17 Subset 


(fact 






Search 1 ^ 1 


Condition: 




Search in: 


[contains 


_^j 




^ gosales w 


“lass: 




Property: 


Query Item 


T 




mm hi 



7. Click Search. 



The results appear as follows: 



Obje ct 



Property 



1, PROMOTION _CODE 
t IP RO D UCTJGO! LDR_CODE 
Qlk PROD UCT_S IZEjCODI E 

[PROD uct_b rand_co d e 

a, W AR EHO US E_B R ANC H_CO D E 
l TERMINATK)N_CODE 

Hgender_cdde 

L, EM P LJ0 YEE_H ISTO R Y_CO D E 
flMANAGER_CODE 

QIeu. rtl_actmty_stat us_co d e 



GO Operationa 
GO Operationa 
GO Operationa 
GO Operationa 
GO Operationa 
GO Operationa 
GO Operationa 
GO Operationa 
GO Operationa 
GO Operationa 



Model \ Found. 
Model \ Found. 
Model \ Found. 
Model \ Found. 
Model \ Found. 
Model \ Found. 
Model \ Found. 
Model \ Found. 
Model \ Found. 
Model \ Found. 



Value 

fact 

fact 

fact 

fact 

fad 

fad 

fact 

fad 

fad 

fact 



You will now use the Bulk Replace feature to change the Usage property for 
these items to Attribute. 
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8. In the bottom right comer of the Tools pane, click Bulk Replace. 

9. Under Replace with, select Attribute. 

The results appear as follows: 




10. Click Replace All, and then click Yes. 



The results appear as follows: 



Object 


Property 


Value 


DU PROMOTION_CODE 


GO Operational Model \ Found... 


attribute 


DH P RO D UCT_CO LO R_C0DE 


GO Operational Model \ Found... 


attribute 


DU P RO D UCT_S IZE_CO D E 


GO Operational Model \ Found... 


attribute 


U P RO D UCTjB RAN D_CO D E 


GO Operational Model \ Found... 


attribute 


|1 W AR EHO US E_B R ANCH_CODE. 


GO Operational Model \ Found... 


attribute 


DH TEHMINAHON_CODE 


GO Operational Model \ Found... 


attribute 


D1gender_code 


GO Operational Model \ Found... 


attribute 


Hi EM P LO YEE_H IST0 R Y_C0 D E 


GO Operational Model \ Found... 


attribute 


D1manager_code 


GO Operational Model \ Found... 


attribute 


Hi RTL_ACTIVITY_STATUS_CODE 


GO Operational Model \ Found... 


attribute 



All Usage properties are now changed to attribute. 



Using the Search tool can save a lot of time when performing these types of 
tasks. However, you should still examine all query items to ensure the settings 
are correct. For example, PRODUCT_BASE_NUMBER from PRODUCT 
and EMPLOYEE_HISTORY_PARENT from EMPLO YEE_HIST ORY are 
still identified as facts. The search did not catch these since they did not contain 
the string _CODE. 
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Task 3. Verify Regular Aggregate property settings. 

1 . Select and test the following query items with Auto Sum enabled: 



Query Subject 


Query Item 


PRODU CT_LINE 


PRODU CT_LINE_EN 


PRODUCTTYPE 


PRODU CT_TYPE_EN 


PRODUCT 


PRODU CT_NUMBER 


ORDER_DETAILS 


QUANTITY 

UNIT_SALE_PRICE 



The results appear as follows: 



[71 Auto Sum 


T est results 






PRODUCT_LINE_EN 


PR 0 D U CT_T YPE_E N 


PRODUCT _NUME!ER 


QUANTITY 


UNIT_SA.LE_PRICE 






Camping Equipment 


Cooking Gear 


1110 


430S828 


6832.88 




Camping Equipment 


Cooking Gear 


2110 


865723 


14111.63 




Camping Equipment 


Cooking Gear 


3110 


866668 


26852.57 




Camping Equipment 


Cooking Gear 


4110 


1 81 21 23 


3866 




Camping Equipment 


Cooking Gear 


5110 


81 3780 


62344.6 





Notice UNIT_SALE_PRICE is summed. This does not meet the reporting 
requirements. In a report on ORDER_DETAILS rolled up for each product 
you would expect the QUANTITY to be summed, but it would make no sense 
to sum up the UNIT_SALE_PRICE (the sale price for one unit of each 
product in the order), since you may have sold several units in one order detail. 
You will change this aggregation to default to something more useful. In this 
case, Average. The same situation applies to UNIT_COST and UNIT_PRICE. 
(Later in the course, you will create a Revenue calculation, QUANTITY * 
UNIT_SALE_PRICE.) 
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2. Click Close, and then in the Project Viewer, under ORDER_DETAILS, 
select the following items: 

• UNIT_COST 

• UNITJPRICE 

• UNIT SALE PRICE 



3. Using the method shown in Task 1, change the Regular Aggregate property 
value to Average for all the items. 

The results appear as follows: 



4. 



5. 



6 . 



Properties 



Properties Language 





Zr 


Display 


MIME Typr^ 


Pmrnpt Info 


Regular 


S 


mUNITjOOST 




Value 






Average 


s 


llUNIT_PRICE 




Value 






Average 


s 


DU UNI T_SALE_P RICE 




Value 






Average 


s 



You will change the format for these objects to $USD Currency. 

In the UNIT_COST row, click on <Click to edit.> under the Format 

heading. 

Under Format Type, select Currency, and then in the Properties pane, 
change Currency to $(USD) - United States of America, dollar. 

Click OK, drag the small black arrow down to change the property setting for 
the other two items, and then on the message, click OK. 

The results appear as follows: 



Properties 



Properties Language 





dden y. 


Usage vv 


Format 


Currency vv 


Ui 


DlUNITjOOST 




Fact 


<dickto edit.> 


USD 


Be 


DHunit_price 




Fact 


=Ockto edit .> 


USD 


Be 


DU UN 1 T_SALE_P RICE 




Fact 


=Ockto edit .> 


USD 


Be 



7. Save the project. 
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Task 4. Test property changes in Framework Manager. 

1 . Select and test the following query items with Auto Sum enabled: 



Query Subject 


Query Item 


PRODU CT_LINE 


PRODU CT_LINE_EN 


PRODUCTTYPE 


PRODU CT_TYPE_EN 


PRODUCT 


PRODU CT_NUMBER 


ORDER_DETAILS 


QUANTITY 

UNIT_SALE_PRICE 



The results appear as follows: 



P Auto 6 uni 



Test results 


PRODUCT_LINE_EN 


PR 0 Dll CT_T VPE_E N 


PR ODUCTJM UMBER 


QUANTITY 


UNIT. SALE_PR!CE 


Camping Equipment 
Camping Equipment 
Camping Equipment 
Camping Equipment 
Camping Equipment 

1 — . n.-. i“. n"..i C .ni ii i“. n.-. l-. V 


Cooking Gear 


1110 


4308828 


5.78066848152542 j 


Cooking Gear 


2110 


885723 


11.85800847457627 


Cooking Gear 


3110 


866669 


22.75641525423728 


Cooking Gear 


4110 


1812123 


3.36101684815254 1 


Cooking Gear 


5110 


81 3780 


44.7235284117647 


1 . 1 ■■ i L-. .n 1 _ ■ — . r 


ci i n 


A .171 7C 


111 07070^07^ 7rf El A 



QUANTITY has been summed while UNIT_SALE_PRICE has been 
averaged. This is based on the property setting you specified earlier. 

2. Click Close. 
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5. Adjust Prompt properties. 

In the Project Viewer, under PRODUCT_LINE select 
PRODU CT_LINE_EN. 

In the Properties pane, scroll down and expand Prompt Info. 

View the options in the drop down list to the right of Prompt Type. 
The results appear as follows: 



El Prompt Info 




Prompt Type 


Server Determined 


Cascade On Hem Reference 


Server Determined 


Display Item Reference 


Edit Box 
Select Date 
Select Date/Time 


Filter Hern Reference 


Use Hern Reference 


Select Interval 
Select Time 
Select Value 


Regular Aggregate 


Semi-Aoarecate 


Select with Search 




Select with Tree 



You can specify the type of prompt that you want generated in Query Studio or 
the default prompt type for Report Studio. The default is for the server to 
determine the prompt type based on data type. 

Here is a brief description of the other properties: 

Cascade on Item Reference is for cascading prompts in Report Studio, for 
example, where the list of Product Type choices is restricted to those within a 
selected Product Line. 

Display Item Reference identifies the default value that a manually created 
Report Studio prompt will display for a particular query item. For example, to 
see a list of PRODUCT_LINE_EN names when using 
PRODUCT_LINE_CODE in a prompt, set the Display Item Reference 
property for PRODUCT_LINE_CODE to PRODU CT_LINE_EN. If this 
field is left blank, it will default to the values returned by query item to which it 
belongs. 
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Use Item Reference identifies the default value that a manually created Report 
Studio prompt will use in the query's filter. For example, for a Report Studio 
generated prompt on PRODUCT_LINE_EN to display a list of 
PRODUCT_LINE_EN names but retrieve data through the 
PRODUCT_LINE_CODE, set the Use Item Reference property in 
PRODU CT_LINE_EN to PRODUCT_LINE_CODE. 

Filter Item Reference identifies the value that an IBM Cognos 10 generated 
prompt will use to filter your query. For example, for Query Studio to display 
PRODU CT_LINE_EN values but use PRODUCT_LINE_CODE in the 
query's filter, set the Filter Item Reference property to 
PRODU CT_LINE_CODE. 

You will set prompt properties on PRODUCT_LINE_EN and 
PRODU CT_TYPE_EN so that they use appropriate indexes in any prompt 
situation to retrieve values from the database. To achieve this, you will set the 
U se Item Reference property to ensure user generated prompts in Report 
Studio are efficient, and you will set the Filter Item Reference property to 
ensure any generic IBM Cognos generated prompt is efficient. You will also 
configure PRODU CT_TYPE_EN to cascade off of PRODUCT_LINE_EN. 

4. In the cell to the right of Use Item Reference, click the ellipsis (...), expand 
Foundation Objects View>gosales> PRODUCT_LINE, click 
PRODU CT_LINE_CODE, and then click OK. 

5. In the cell to the right of Filter Item Reference, click the ellipsis (. . .), expand 

Foundation Objects View>gosales>PRODUCT_LINE, click 
PRODU CT_LINE_CODE, and then click OK. 

The results appear as follows: 



□ Prompt Info 




Pionipt Type 


Server Determined 


Cascade On Item Reference 




Display Item Reference 




Filler Item Reference 


Igosales] .[P RO D UCTJJN E] .[P RO D UCTJLIN E_C0 D E] 


Use Item Reference 


Igosales] JP RO D UCTJJIN E] .[P RO D UCT_UINE_COD E] 



6. Save the project. 
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Task 6. Test the prompt property change in Query Studio and 

Report Studio. 



1 . 

2 . 

3. 



4. 

5. 



6 . 

7. 



Publish the GO Operational package again, overwriting the earlier version. 

Launch IBM Cognos Connection, log on, and then launch Query Studio 

selecting the GO Operational package. 

Add the following items to the report: 



Query Subject 


Query Item 


PRODU CT_LINE 


PRODU CT_LINE_EN 


ORDER_DETAILS 


QUANTITY 



Select the PRODUCT LINE EN column and then click Filter 




Select Camping Equipment and then click OK 



The query retrieves the expected row. 



PRODUCT_LINE_EN 


QUAhn nrr 


Camping Equipment 


27,30 1, 149 


Sum nary 


27,301,149 



To view the underlying SQL, you will convert the Query Studio report to a 
Report Studio report. 



Under Menu, click Manage File, and then click Open in Report Studio. 

In Report Studio, from the Tools menu, click Show generated SQL/MDX, 
and then, in the Generated SQL/MDX list, select IBM Cognos SQL. 



Note that the Where clause uses 

(PRODU CT_LINE.PRODUCT_LINE_CODE in (’991’)). This shows that 
you are retrieving data based on indexed codes rather than the less-efficient and 
non-indexed PRODUCT_LINE_EN strings. 
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8. Click Close, and then close Report Studio and Query Studio without saving 
the reports. 

Results: 

To meet reporting requirements, you verified that important query 
item properties such as Usage and Regular Aggregate were correct. 
Also, to make filtering more efficient, you configured 
PRODUCTJJNE _EN to use PRODUCTJJNE _CODE when filtering 
on PRODUCT LINE EN. 
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Workshop 1 : Verify and Modify Query Item Properties. 



After every import of metadata, you need to verify that query item properties meet the 
needs of the business analysts creating reports for the Great Outdoors. You should: 

• Verify query item properties. Change the Usage property from Fact to Attribute 
where numeric query items are neither facts nor indexes. 

• In the PRODUCT query subject, ensure that PRODUCTION_COST and 
GROSS_MARGIN are averaged when their values are summarized. 

• In the COUNTRY query subject, change COUNTRY_EN so that when a 
prompt is manually created or automatically generated it will cause retrieval 
through the COUNTRY_CODE key. 

• Publish the package and verify your prompt works using Query Studio and 
Report Studio. 

For more detailed information outlined as tasks, see the Task Table on the next page. 
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Workshop 1: Task Table 



Task Where to Work Hints 

1. Change query item Project Viewer • Ctrl+ click all desired query items to 

Usage properties. and Property make the same change to multiple items 

panes at once. 

• Change U sage to Attribute for numeric 
query items that are not facts for the 
following items: 

• PRODUCT> 
BASEJPRODUCTJMUMBER 

• EMPLO YEEJHI ST O RY > 
EMPLO YEEJHI ST O RY_ 
PARENT 

2. Change Regular Project Viewer • Ctrl+click all desired query items to 

Aggregate and Property make the same change to multiple items 

properties. panes at once. 

• Set the Regular Aggregate property to 
Average for the following items: 

• PRODUCT>PRODUCTION_ 
COST 

• PRODUCT>GROSS_MARGIN 

3. Change prompt Project Viewer • Change the Filter Item Reference and 

properties. and Property Use Item Reference properties for 

panes COUNTRY > COUNTRY_EN to 

use 

COUNTRY > COUNTRY_CODE 
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Query Studio, 
Report Studio 



5-34 © 2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 

or translated into another language without a legal license agreement from IBM Corporation. 



• Publish GO Operational package. 

• In Query Studio, create a query using 
the following items: 

• COUNTRY > COUNTRY_EN 

• ORDER_DETAILS> 
QUANTITY 

• Filter COUNTRY_EN on Canada. 

• Open the report in Report Studio and 
use Tools > Show Generated 
SQL/MDX to see if retrieval is through 
COUNTRY_CODE. 

• In Framework Manager, save and close 
your project. 



4. Publish the package 
and verify your 
prompt works 
using Query and 
Report Studio. 









PREPARE REUSABLE METADATA 



Workshop 1 : Results 



T ask 4. 



After filtering the report in Query Studio, the results appear as follows: 





Mfcv fH 


QUANTITY 


Canada 


4,052,045 


Sum nary 


4,052,045 



After viewing the SQL in Report Studio, the results appear as follows: 



IBM Cognos SQL 
select 



zi 



COUNTRY . COIJNTR Y_EN as COUNTRY_EN, 

XSUM{ORDER_OET AILS , QUANTITY for COUNTRY. COUNTRY_EN ) as 
QUANTITY, 

XSUM{XSUM(ORDER_DET AILS . QUANTITY for COUNTRY. COUNTRY_EN ) at 
COUNTRY. COUNTRY JEN ) as QUANTTTY3 
from 



GOS ALES . ,. GOS ALES COUNTRY COUNTRY, 

GOS ALES . . GOS ALES . ORDER_DET AILS ORDER_DETAILS, 



GOS ALES. .GOS ALES. BRANCH BRANCH, 

GOSALES. .GOS ALES. ORDER HEADER ORDER HEADER 




(COUNTRY. COUNTRY_CODE = BRANCH. COUNTRY_CODE) and 
(BRANCH. BRANCHjCODE = ORDER_HEADER . SALES_BRANCH_CODE} and 
(ORDER_HE ADER . ORDER_NUMBER = ORDER_DET AILS . ORDER_NUMBER) 
group by 



COUNTRY. COUNTRY EN 



The SQL generated in Report Studio for the Query Studio query shows that you are 
accessing the data through COUNTRY_CODE. 
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Business Analytics 

Summary 

■ You should now be able to: 

■ verify relationships and query item properties 

■ ensure efficient filters by configuring prompt 
properties 






Oognos* 

software 
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Business Analytics 

Objectives 

■ At the end of this module, you should be able to: 

■ describe multi-fact queries and when full outer 
joins are appropriate 

■ describe how IBM Cognos uses cardinality 

■ identify reporting traps 

■ use tools to analyze the model 



Cognos, 

software 
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Framework Manager Workflow 



Framework Manager 



Create 

Project 




Import 

Metadata 



Prepare 

Metadata 



Publish 



Set 

Security 



Model 

Metadata for 
Reporting 



Create and 
Manage 
Packages 



Data 

Sources 



Content 

Store 



Report Studio 
Query Studio 
Analysis Studio 



Cognos. 

software 
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This module deals with identifying potential reporting issues before beginning to model 
the metadata. 

Solutions to the issues found in this module will be applied in later modules. 
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The measures can be constricted by dimensional attributes taken from related 
dimension query subjects at the 1..1 end of 1..1 to l..n relationships. 

In most cases, single-fact queries are not a problem for reporting and usually generate 
simple and expected SQL. 

If you change the cardinalities to be optional (0..1 and 0..n) you will see full outer joins 
in the generated SQL. These types of joins would be expected in the SQL since you 
requested them. 
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Business Analytics 

Why Are Multi-Fact Queries Complicated? 

■ Examine the following data: 



Returned Items Fact 

Cognos. 

software 

©2010 IBM Corporation 



DAY_DATE 


ORDER_METHOD 


SALE_TOTAL 


01/01/2005 


E-mail 


$10 


01/02/2005 


Telephone 


$25 


01/03/2005 


Web 


$40 


01/04/2005 


E-mail 


$20 



Sales Fact 



DAY_DATE 


ORDER_METHOD 


RETURN_QUANTITY 


01/01/2005^ 


E-mail 


2 


01/02/2005 


Telephone 


4 


01/10/2005 


Fax 


15 


01/11/2005 


Sales visit 


1 
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Business Analytics 

Why Are Multi-Fact Queries Complicated? 
(cont'd) 

■ An inner join in a select statement assumes that the 
same information exist in both facts 



< > 

< > 



Select a.SALE_TOTAL, b.RETURN_QUANTITY from Sales a, Returns b 

Where a.DAY_DATE = b. DAY_DATE and a.ORDER_METHOD = b.ORDER_METHOD 



Cognos. 

software 

©2010 IBM Corporation 



DAY_DATE 


ORDER_METHOD 


SALE_TOTAL 


01/01/2005 


E-mail 


$10 


01/02/2005 


Telephone 


$25 


01/03/2005 


Web 


$40 


01/04/2005 


E-mail 


$20 



Sales Fact 



DAY_DATE 


ORDER_METHOD 


RETU RN_QU ANTITY 


01/01/2005 


E-mail 


2 


01/02/2005 


Telephone 


4 


01/10/2005 


Fax 


15 


01/11/2005 


Sales visit 


1 



Returned Items Fact 



An inner join would only return the first two records. If a filter ORDER_M E THOD — 
'Web' was added, 0 records would be returned. 

Data is lost in this scenario. 
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Business Analytics 



Why Are Multi-Fact Queries Complicated? 
(cont'd) 

■ full outer joins can break queries into multiple selects, 
one for each fact table, and merge data 

Sales Fact 



Returned Items Fact 



DAY_DATE 


ORDER_METHOD 


SALE_TOTAL 


01/01/2005 


E-mail 


$10 


01/02/2005 


Telephone 


$25 


01/03/2005 


Web 


$40 * 


01/04/2005 


E-mail 


$20 




DAY_DATE 


ORDER_METHOD 


RETU RN_QU ANTITY 


01/01/2005 


E-mail 


2 


01/02/2005 


Telephone 


4 


01/10/2005 


Fax 


15 


01/11/2005 


Sales visit 


1 



Report Set 



DAY_DATE 


ORDER_METHOD 


SALE_TOTAL 


RETU RN_QUANTITY 


01/01/2005 


E-mail 


$10 


2 


01/02/2005 


Telephone 


$25 


4 


01/03/2005 


Web 


$40 




01/04/2005 


E-mail 


$20 




01/10/2005 


Fax 




15 


01/11/2005 


Sales visit 




1 
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No data is lost. 

This is what IBM Cognos refers to as a stitch query. 
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Conformed dimensions contain the descriptive attributes and corresponding names, 
meanings, and values that have been agreed to across the enterprise. 

Conformed dimensions can be used to merge two independent fact queries together, as 
seen in the slide example above, without loss of data. In this case, the Product 
dimension is used to stitch the results of query 1 and query 2 together on the common 
value selected from the Product dimension. Again, as seen on the previous page, no 
values are lost on either side of the query. Where the facts have the same data in 
common, both fact cells contain values. Where a fact does not share common data, the 
fact cells are null. 

If the data source supports this type of query, the processing will be done at the data 
source level. If not, the processing will be done on the IBM Cognos servers. 

We will examine the anatomy of a stitch query later in the course. 
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Typically, facts are found on the l..n side of a query. The facts found in these tables can 
then be aggregated if requested by the user. 

For every generated query, IBM Cognos identifies each query subject as either a "fact" 
or a "dimension" based on cardinality. Query subjects with only 0..n or l..n cardinalities 
attached are identified as facts and query subjects with 0..1 or 1..1 cardinalities attached 
are identified as dimensions. 

Query subjects with both types of cardinality attache have the potential to be 
ambiguous. This is the case with ORDER_HEADER. 
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Again, query usage is applied based on which query subjects are used in a query. 

In the slide example, ORDER_HEADER has both 1..1 and l..n cardinalities attached. 
Since fact query subjects must have only l..n or 0..n cardinalities attached, 
ORDER_HEADER will be treated as a dimension in this scenario. 
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Cardinality Usage in IBM Cognos (cont'd) 

■ Examine a query using these query subjects 




Fact 



Cognos. 

software 



>2010 IBM Corporation 



In this query scenario, ORDER_H E ADER has only l..n cardinalities attached. 
Therefore it will be treated as a fact. 
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Business Analytics 

When Does IBM Cognos Generate Stitch 
Queries? 



Time is a conformed dimension 




Sales Fact and Sales Target Fact have only l..n cardinality 
attached and are therefore treated as facts and stitched 

together in this query 



Cognos. 

software 
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When one or more conformed dimensions are used in a multi-fact query (where query 
subjects are identified as facts by the IBM Cognos query engine), a stitch query (full 
outer join) will occur. 

A stitch query is required when you have different levels of granularity between the 
facts and do not want to lose uncommon rows of data. 
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Business Analytics 



When You May Not Want a Stitch Query 



When the level of granularity is the same for both facts, 
a stitch query (full outer join) may be unnecessary 




Pay and Federal Tax Deduction will not be identified as facts 
due to cardinality and therefore no stitch query will 

be performed 



Cognos. 

software 
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In cases where the facts are at the same level of granularity, you may want to avoid the 
extra processing of a full outer join and simply configure 1..1 to 1..1 relationships 
between your dimension and fact query subjects. 

You must be extremely familiar with your data and the expected results when 
implementing this type of configuration. U se this approach with caution as there is 
potential to prevent required stitch queries as the model scales and involves dimensions 
with different levels of granularity. 
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Business Analytics ^ 

Identify Reporting Traps 

■ Reporting traps can occur when you: 

■ reference two facts with no dimension context 

■ generate unwanted query splits (full outer joins) 

■ write reports with query subjects that have 
ambiguous joins 



Qognos* 

software 
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When begi n ning to model for predictable results, you will want to initially identify any 
reporting traps that exist within your model. 

We will cover these reporting traps throughout this module. 
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Reporting Traps: Reference Two Facts With 
No Dimension Context 



Query 1: Incorrect - results in cross-join 




A query on two facts with no dimension context is treated as a cross-product join. This 
brings duplicate data from the two datasets together in one query. Authors can 
accidentally author these types of queries if you have left textual (dimensional 
information) items in a fact query subject. For example, if Retailer name was a query 
item in SALES_TARGET, authors might choose this item thinking it also applies to 
ORDERJDETAILS. 

This can be avoided if textual items are removed from the fact query subjects. Doing so 
will force authors to use at least one common dimension in the query to join the facts 
together. In Query 2, retailer information is taken from RETAILER. 
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Business Analytics ^ 

Reporting Traps: Reference Two Facts With 
No Dimension Context (cont'd) 



Query Subjects 




overall values 

©2010 IBM Corporation 
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The query above returns the distinct overall total of Quantity and applies it to each 
Retailer name row. 

Again, in this scenario, authors can accidentally misuse Retailer name from the 
S ALE S_T ARGFT fact query subject and cause unexpected results. Taking Retailer 
name from the conformed dimension would generate a stitch query and provide 
expected results. 
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Purpose: 

A common requirement for the business analysts will be to generate 
a report that compares sales targets against actual sales. You will 
test such a report to identify possible reporting traps. 

Components: Framework Manager, Business Insight Advanced 

Project: GO Operational 

Package: GO Operational 

Task 1 . Add S ALES_TARG ET table to the model. 

1. In Framework Manager, close any projects that may be open, and then open 
the GO Operational project located at C:\Edcognos\B5152\ 

CBIFM-Start Files\Module 6\GO Operational. 

2. Log in as User ID admin, Password Education!.!, if prompted. 

3. In the Project Viewer, expand GO Operational Model > Foundation 
Objects View, right-click the gosales namespace, and then click Run 
Metadata Wizard. 

You will import SALES_TARGET from the GOSALES database. 

4. Ensure that Data Sources is selected, and then click Next. 

5. Ensure that GOSALES is selected, and then click Next. 

6. In the list of objects, expand GOSALES and Tables, and then select the 

S ALEST ARGET table. 

7. Click Next. 
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8. On the Generate Relationships page, click the Both radio button as shown 
below. 

Select between which set of objects you want to detect and generate relationships. 

C Between the imported query subjects 

C Between each imported query subject and all existing query subjects in the model 
ff Both 

You want to generate relationships among the new query subjects as well as 
between the new and existing query subjects. This will prevent you from having 
to manually create the relationships after the import. 

9. Click Import. 

The import process begins, and then a message appears summarizing the count 
of objects that were imported. 

10. Click Finish. 

Task 2. Try to create a Targets vs. Actual Revenue report. 

1 . Publish the GO Operational package 

2. Launch IBM Cognos Connection, log in, and launch Report Studio, 

selecting the GO Operational package for a List report. 
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3. Drag the following query items to the report: 



Query Subject 


Query Item 


SAT ES_T A R GET 


RETAILERNAME 
SALE S_T ARGET 


ORDER_DETAILS 


QUANTITY 

UNIT_SALE_PRICE 



You could have taken COMPANY_N AM R from RETAILER, but to identify 
potential areas of unpredictability for authors you will take it from 

SALES TARGET. 



4. Click the Run button and select Run Report — HTML. 
The results appear as follows: 



RETAIL ER_N AM E 


SALESJTARGET 


QUANTITY 


UNIT_SALE_PRICE 


1 for 1 Spoils shop 


5,666,300 


69,237,091 


5120.12 


4 Golf only 


4,365,300 


69,237,091 


5120.12 


4 Your Eyes 


766,300 


39,237,091 


5120.12 


Aarhus Sport 


5,268,300 


39,237,091 


5120.12 


Accapamentc 


5,336,000 


39,237,091 


5120.12 



The resulting report has the same QUANTITY and UNIT_SALE_PRICE for 
every row, which is unexpected. To complete the report, you would create a 
calculation of quantity times unit sale price to get actual revenue values, but 
there is no need to continue since an issue has already been found. 

5. Close your Internet browser. 
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Task 3. Analyze the query in Framework Manager. 

1 . In Framework Manager, in the Diagram, locate S ALE ST ARGET and 
ORDER_DETAILS. 

There are no direct relationships between these two query subjects. To see how 
they are joined in a query, you will recreate the same query in Framework 
Manager and view the generated SQL. 

2. In the Project Viewer, select and test the following query items with Auto 
Sum enabled: 



Query Subject 


Query Item 


SALES_TARGET 


RETAILERNAME 
SALE S_T ARGET 


ORDER_DETAILS 


QUANTITY 

UNIT_SALE_PRICE 
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3. Click the Query Information tab. 
The results appear as follows: 




The query has two subqueries (aliased as D2 and D3) in the from clause that are 
not joined. The two queries are simply separated by a comma with no join 
conditions. This is known as a cross-product join. In this case, one query is on 
all sales targets grouped by retailer name, and the other is on a distinct value for 
all order quantities and unit sale prices with no grouping. This explains why all 
the quantities and prices are the same. IBM Cognos does not join the two query 
structures because they are both facts and there is no conformed (shared) 
dimension joining them. 

You will need an alternate source for RETAILER_NAME, so you will try the 
only other instance of RET AILE R_NAM E in the project, the one in 
ORDER_HEADER. 

4. Click Close. 
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Task 4. Attempt a resolution. 

1 . Select and test the following query items with Auto Sum enabled: 



Query Subject 


Query Item 


ORD ER_H E AD ER 


RETAILERNAME 


SAT ES_T A R GET 


SALE S_T ARGET 


ORDER_DETAILS 


QUANTITY 

UNIT_SALE_PRICE 



The results appear as follows: 



</ Auto Surd 



T: est results 





RETAILEFi_NAME 


SALES_T ARGET 


QUANTITY 


UNIT_SALE_PRICE 




1 fori Sports shop 


4205368540 


1 64233 


88.01826828281461 




4 Golf only 


4205368540 


53570 


178.48830373746835 




Aarhus Sport 


4205368540 


117117 


114.0472600618185 




Accapamento 


4205368540 


1 52551 


104.36630165288256 



You can now see separate quantities and unit sale prices for each retailer, but 
the sales targets are now all identical. 
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2. Click the Query Information tab. 
The results appear as follows: 



Cognos SQL 



select 



from 



B3 . RE TAI LER_NAME as RE TAI LE R_MAME , 

D2 . SALE S TARGE T as SALE S_T ARGE T , 

D3 . QUANTITY as QUANTITY , 

D3 . UNIT SALE PRICE as UNIT SALE PRICE 



(select distinct 

XSUM ( SALES TARGET . SALE S TARGE T ) as SALE S TARGE T 

from 

GOSALE S . GOSALE S . gosales . SALE S TARGE T SALE S TARGE T 

) D2, ~~ ~~ 



(select 

ORDER_HEADER . RE TAI LE R_MAME as RE TAI LE R_MAME , 

XSUM ( ORDER_D E TAI LS . QUANT I T Y for ORDER_H EAD E R . RE TAI LERN 
ZAVG (ORDER_DE,TAI LS . UNI T_SALE_P RICE for ORD ER_HEADER . RET 

from 

GOSALES . GOSALES . gosales . ORDER_HEADER ORDER_HEADER, 
GOSALES . GOSALES . gosales . ORDER_DETAI LS ORDER_DETAI LS 

where 

(ORDER_HEADER. ORDER_NUMBER = ORDER__DETAI LS . ORDER_NUMBER) 
group by 

ORD ER_HEADER . RE TAI LE R_NAME 



Once again you have two subqueries that are not joined. However, this time it is 
sales targets that are not grouped by retailer name. IBM Cognos still does not 
join the two query subjects because you have not provided a conformed 
dimension. 

If you speak with the database administrator, you will find out that 
COMP ANY N AM R in the RETAILER query subject holds the retailer name 
that can be used between the two fact query subjects. You will try this in the 
next task. 

3. Click Close. 
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Task 5. Correct the query. 

1 . Select and test the following query items with Auto Sum enabled: 



Query Subject 


Query Item 


RETAILER 


COMPANY_NAME 


SAT ES_T A R GET 


SALE S_T ARGET 


ORDER_DETAILS 


QUANTITY 

UNIT_SALE_PRICE 



The results appear as follows: 



17 Auto Sunl 
* 



I est results 




COMPANY. NAME 


SALES, _TA.FIGET 


QUANTITY 


UNIT .SALE PRICE 


1 for 1 Sports shop 


5666300 


1 64233 


99.01 926928281 461 




4 Golf only 


4365300 


53570 


178.48830378746835 




4 Your Eyes 


766800 


1 4828 


106.64756756756756 




Aarhus Sport 


5268300 


117117 


114.0472600618185 




Accapamento 


5338600 


152551 


104.36630165288256 



You can now see separate targets, quantities, and prices for each retailer. If you 
were to create this report in Query Studio, you would now calculate Actual 
Revenue to compare against the targets. (You will not do this now in order to 
continue investigating modeling issues and will create a Revenue calculation in 
the model later in the course.) 
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2 . 
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Click the Query Information tab. 

The results appear as follows: 

Cognos SQL 

select 

c o ale s c e ( D 2 . CCMFANY_NAME ,D3. CCMPANY_NAME ) as CCMPANY_NAME , 

D 2 . SALE S TARGET as SALE STARGET , 

D 3 . QUANT I T Y as QUANT I T Y , 

D 3 . UN I T_SALE_FRI CE as UNI T_SALE_FRI CE 

from 

( select 

RETAI LER , CCMPANYNAME as CCMPANYNAME , 

XSUM ( ORDERDETAI LS . QUANT I T Y f o r RE TAI LER . CCMPANY_NAME ) as i 
XAVG ( ORDER_DETAI LS . UN I T_SALE_PRI CE f o r RE TAI LE R . CCMPANY NAME 

from 

GOSALE S . GO SALE S . go s ale s r t . RE TAI LE R RE TAI LER , 

GO SALE S . GOSALE S . go s ale s . ORDERDETAI L S ORDER_DETAI L S , 

GOSALE S . GOSALE S . go s ale srt.RE TAI LE R_S I TE RE TAI LER_S I TE , 

GOSALE S . GOSALE S . go sales . ORDER_HEAJDER ORDERHEADER 

where 

[RETAI LER . RETAI LERCODE = RETAI LERS I TE , RETAI LERCODE) and 
( RE TAI LER S I TE . RE TAI LER S I TE CODE = ORDER HEADER . RE TAI LER S I TE 
(ORDER HEADER. ORDER NUMBER = ORDER DETAI LS . ORDER_NUMBER) 
group by 

RETAI LER, CCMPANY NAME 
full outer join 

RETAI LER , CCMPANY NAME as CCMPANY NAME , 

XSUM ( SALESTARGET . SALESTARGET for RETAILER. COMPANY_NAME ) a: 

from 

GOSALE S . GOSALE S . go s ale srt.RE TAI LE R RE TAI LER , 

GOSALE S . GO SALE S . go s ale s . SALE S TARGET SALE S TARGET 

where 

( RE TAI LER . RE TAI LERCODE = SALE STARGET . RE TAI LERCODE > 
group by 

RETAILER, CCMPANY NAME 

I ™? 

There are two subqueries joined by COMPANY_NAME (retailer name) 
through a full outer join. Again, in this case, a full outer join is expected since 
you are stitching two separate fact queries together. 

The query scenarios you just went through support the concept of ensuring 
descriptive data is retrieved from dimensions and not facts. 
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3. Click Close, and leave Framework Manager open for the next demo. 

Results: 

A common requirement for the business analysts will be to compare 
sales targets against actual sales. You tested such a query, 
identified a reporting trap, and identified a proper query to return 
expected results. 
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Unwanted query splits (full outer joins) occur when query subjects (such as 
PRODUCT_NAME_LOOKUP in Query 1) are incorrecdy identified as facts. 

In this case PRODUCT_NAME_LOOKUP contains several values for each product 
in the PRODUCT table, one for each supported language in this multilingual table. The 
intent is for PRODUCT_NAME_LOOKUP to behave as a lookup table and return 
one value per product. Instead it acts as a fact based on cardinality. 

In Query 2, the cardinality for PRODUCT_NAME_LOOKUP has been changed to 
1..1 after a filter is put in place to ensure only one value is returned. In this scenario, it 
will always act as a dimension 
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Demo 2: Generate Unwanted Query Splits 



Purpose: 

Authors will want to report on the overall quantity of products sold. 
You will test such a query to identify a possible reporting trap. 



Component: Framework Manager 

Project: GO Operational 

Task 1 . Create a query to view total quantity sold by product. 

1 . In Framework Manager, select and test the following query items with Auto 
Sum enabled: 



Query Subject 


Query Item 


PRODU CT_NAME_LOOKUP 


PRODU CT_NAME 


PRODUCT 


PRODU CT_NUMBER 


ORDER_DETAILS 


QUANTITY 



In order to return a larger result set, you will alter the options. 



2. Click Options in the lower right comer, under Number of results, change the 
value from 25 to 250, and then click OK. 

Other options will be covered later in the course. 
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3. Click Test Sample. 



The results appear as follows: 



T est results 


product jiame 


PRODUCT, NUMBER 


QUANTITY 


Beg Air T rail Chef 


1110 


4308828 


BukEak n a wode BiwaKuchnia 


1110 


4308828 


Cantimplora flexible Cocinero Viajero 


1110 


4308828 


Citerne souple ChefDeCamp 


1110 


4308828 


Contenitore per liquidi Chef 


1110 


4308828 


F riluf tskockens vatskebehallare 


1110 


4308828 


Kantung Air T railChef 


1110 


4308828 


M ochila-cantil S errania 


1110 


4308828 


Nomad szakacs ffakon 


1110 


4308828 


Pionierwaterzak 


1110 


4308828 



Notice the different language name but the same quantity value for the same 
product number. 

PRODUCT_NAME_LOOKUP is a table in the database that contains 
multiple rows for each product, one for each supported language. Because there 
are multiple rows, the relationship is currendy correct. 1..1 from PRODUCT to 
l..n to PRODUCT_NAME_LOOKUP. It is not that this query is incorrect, 
but it may not be what the author expected. Likely you would want to see one 
product, in one language, with one summarized QUANTITY value. 

You will look at the SQL to see what occurred. 
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4. Click the Query Information tab. 



The results appear as follows: 



Cognos SQL 



select 



f rom 



D2 „ FRODUCT_NAME as PRODUCTNAME , 

c o ale see (D2 . PRODUCT_NUMBER f D3 . PRODUCT_NUMBER) as PRODUCTNUMBER , 
D 3 - QUANT I T Y as QUANT I TY 



(select distinct 

P RO D UC T NAME L O OKU P . FRODUCT_MAME as FRODUCT_NAME , 

PRDDUCT_NAME_LOORUF . PRODUCT NUMBER as PRODUCT NUMBER 

from 

GO SALES , GOSALES . go sales „ PRODUCT_NAME_LOORUP PRODUCT_NAME_LOORUP 

(select 

ORDERDETAI L S . PRODUCT_NUMBER as PRODUCT NUMBER , 

XSUM ( ORDER_DETAI LS . QUANT I T Y for ORDER_DETAI L S . PRODUCT_NUMBER > 

from 

GOSALE S , GOSALE S . go s ale s . ORDER_DETAI L S ORDER DETAI L S 
group by 

ORDER DETAI LS . PRODUCT NUMBER 

) D3 

on (D 2. PRODUCT NUMBER = D 3. PRODUCT NUMBER) 



Notice the two subqueries that are being joined with a full outer join. One 
retrieves all the multilingual product names for each product number, and the 
other, summarized order quantities for each product number. The two queries 
are then stitched together. This is an unwanted query split, since the intent in 
this query is to return one product name per product and show the quantities 
sold for that product. 



5. Click Close. 
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Task 2. Examine the objects and their cardinality. 

1 . Click Diagram on the right side of the screen. 

In the diagram, locate PRODUCT_NAME_LOOKUP, PRODUCT, and 
ORDER_DETAILS. 



The results appear similar to as follows: 



ORDER DETAILS 



A 



ORDER DETAIL CODE 
ORDER NUMBER 
SHIP DATE 
PRODUCT NUMBER 
PROMOTION CODE 



QUANTITY 



UNIT COST 
UNIT PRICE 
UNIT SALE PRICE 



7 



1..n 1..1 



1..n 



PRODUCT 



A 



BASE PRODUCT NUMB... 
INTRODUCTION DATE 
DISCONTINUED DATE 
PRODUCT TYPE CODE 
PRODUCT COLOR CODE 
PRODUCT SIZE CODE 
PRODUCT BRAND CODE 
PRODUCTION COST 
GROSS MARGIN 




ffi PRODUCT NAME 


LOOKUP ^ 


PRODUCT 


NUMBER 


PRODUCT 


LANGUAGE 


PRODUCT 


NAME 




PRODUCT 


DESCRIPTION 




PRODUCT TYPE 



¥ 



PRODUCT TYPE CODE 
PRODUCT LINE CODE 
PRODUCT TYPE EN 
PRODUCT TYPE FR 
PRODUCT TYPE DE 
PRODUCT TYPE NL 
PRODUCT TYPE JA 

nnr-.ni i~-t Tvnr on 






ffi F 




PR 01 




FROI 




PR 01 




FROI 




FROI 




FROI 




FROI 


nn r\ i 



In this scenario, PRODUCT is treated as a dimension (only 1..1 cardinalities 
attached), and ORDER_DETAILS and PRODUCT_NAME_LOOKUP are 
treated as facts (only l..n cardinalities attached). 

You will resolve the PRODUCT_NAME_LOOKUP issue later in the course 
by applying a filter and changing the cardinality. 

Results: 

You tested a query on total quantity sold by product to identify a 
possible reporting trap and found an unwanted query split. 
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Business Analytics 



Reporting Traps: Ambiguous Joins 




©2010 IBM Corporation 



Remove the risk of taking the wrong query path by removing the ambiguity: Creating 
aliases of COUNTRY with the appropriate relationships allows report authors to 
choose the desired path, in this case order details by retailer country or branch country. 
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Demo 3: Identify Ambiguous Joins 



Component: Framework Manager 

Project: GO Operational 



Purpose: 

Another common requirement for the business analysts will be to 
report on sales figures by retailer country. You will test such a query 
to identify a possible reporting trap. 



Task 1 . Create the report. 

1 . In Framework Manager, select and test the following query items with Auto 
Sum enabled: 



Query Subject 


Query Item 


COUNTRY 


COUNTRY_EN 


ORDER_DETAILS 


QUANTITY 



The results appear as follows: 



COUNTRY _EN 


QUANTITY 


Australia 


1 599920 


Austria 


1 G60769 


Belgium 


1 30271 G 


Brazil 


1 741 344 


Canada 


4052045 


China 


441 31 27 


Finland 


27849G9 


France 


3948439 


r- 





The goal is to create a query for the number of units sold in each retailer's 
country. These results seem like they might be correct. But to be sure, you will 
look at the SQL generated for this query. 
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2. View the SQL on the Query Information tab. 

The results appear as follows: 

Cognos SQL 

select 

COUNTRY . COUNTRY EN as COUNTRY_EN , 

ZSUM (ORDERDETAI LS . QUANTITY for COUNTRY . COUNTRYEN ) as £ 

from 

GO SALE S . GO 1 SALE S . go sales . COUNTRY COUNTRY , 

GOSALES . GO 1 SALES . go sales . ORDER_BETAI LS ORBER_DETAI LS , 

GO SALES . GOSALES . go sales . ORDERJHEADER ORDERJHEADER, 

GOSALE S . GOSALE S . gosales . BRANCH BRANCH 

wliere 

(COUNTRY . COUNTRY CODE = BRANCH . COUNTRY_CODE ) and 

(BRANCH . BRANCH JCODE = ORDER_HEADER. SALES_BRANCH_CODE) and 
(ORDERJHEADER. ORDER_NUMBER = ORDERJ3ETAILS . ORDERJIUMBER) 
group by 

COUNTRY . COUNTRY_EN 

The query did not take the path you wanted (through RETAILER_SITE) . 
Instead, it took the path through BRANCH to ORDER_HEADER to 
ORDER_DETAILS . So the query set returned the number of units sold in 
each sales branch country. 

3. Click Close. 

Task 2. Examine the objects and their relationships. 

You will use a feature called Context Explorer that helps you isolate modeling objects 
for closer examination and testing. It is a focused subset of the overall diagram. You 
will first change the default behavior of the Context Explorer to only show objects you 
select and not all related objects of the items you select. 

1 . From the Diagram menu, click Diagram settings. 

2. Click the Context Explorer tab, select Show only the selected objects, and 

then click OK 
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3. In the Project Viewer, select the following query subjects: 

• COUNTRY 

• BRANCH 

• RETAILERSITE 

• ORDERJHEADER 

• ORDER_DETAILS 

4. Right-click one of the selected objects, and then click Launch Context 
Explorer. 
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ISSUES 



5. Arrange the diagram as shown below: 



IBB COUNTRY 

•COUNTRY CODE 
COUNTRY EN 
COUNTRY CS 
COUNTRY DA 
COUNTRY DE 
COUNTRY EL 
COUNTRY ES 
! COUNTRY FI 





When a query can take more than one path of equal length and all query 
subjects are in a single namespace or folder, IBM Cognos chooses the 
relationship that comes first alphabetically. U sing modeling techniques such as 
alias query subjects, you can avoid all ambiguity. 

You will apply a solution in the next module. 
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6. Close the Context Explorer, and leave Framework Manager open for the next 
demo. 



Results: 

You tested a query on sales by country, intending the countries to 
be for retailers. Because there were multiple query paths that could 
be used, you discovered the potential for unpredictable results. 
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Business Analytics 



Use Tools to Analyze the Model 



Recommendation #4 




Verify Model: identifies errors 

Model Advisor: identifies areas needing review ■ 

Model in freehand to identify: 

■ which query subjects can act as either a fact or a 
dimension 






■ fact query subjects that include descriptive data 



■ unclear query paths 

■ groupings of data (which items will be used to 
create a fact or dimension query subject for 
presentation to end users?) 

Qognos* 

software 

©2010 IBM Corporation 



Verify Model: After you select the conditions and severity for which you want to test, 
Verify Model identifies the errors and offers automated or manual repairs. 

Model Advisor: After you select the conditions for which you want to test, Model 
Advisor gives a clear, graphical presentation that summarizes the design issues 
uncovered and offers links to documentation for evaluating and resolving the issues. 

Modeling in freehand: Use a diagram printout to identify areas for concern and how 
you will build your final model. Concentrate on modeling dimensions first, since they 
are usually easy to identify, more problematic, and can resolve most of the modeling 
design issues. 



©2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 
or translated into another language without a legal license agreement from IBM Corporation. 



6-39 



Purpose: 

Prior to modeling the metadata, you will analyze the model for errors 
and design issues. 

Component: Framework Manager 

Project: GO Operational 

Task 1 . Analyze for errors. 

1 . In the Project Viewer, right-click the gosales namespace, and then click 

Verify Selected Objects. 

The Options tab lets you control two aspects of the verification process: the 
severity and the categories of verification. You will accept the defaults. 

2. Click Verify Model. 

No issues have been detected in this simple model. Note the Repair Selected 
tool, and the ability to group reported issues by object id, severity, or message 
description. 

3. Click Close. 

You can perform this verification process on any level under the root 
namespace of the project or verify the entire model from the Project menu. 

Verification is also performed by default when publishing a package. All 
contents of the package are verified unless you deselect the option in the 
publish wizard. 
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Task 2. Analyze for design issues. 



1 . In Project Viewer, right-click gosales and then click Run Model Advisor. 

The Options tab lets you control three forms of analysis: relationships, 
determinants, and miscellaneous checks. You will accept the defaults. 

2. Click Analyze. 

The results appear similar to as follows: 



Issue 1: Facts identified by cardinality 




This query subject is identified as a fact because of the cardinality of its relationships. It is 
recommended that you review the implications of this to SQL generation and r if appropriate r 
change the usage of this query subject or its relationships. More information about cardinality 



Object Name 
M EMPLOYEES 1ST DRY 



Problem Description 

The query subject EMFLOYEE_HISTORY is on the many 
side of all its referencing relationships. 

The query subject S.ALES_TARGET is on the many side 
of all its referencing relationships* 

The query subject DRDER_DETAILS is on the many side 
of all its referencing relationships* 

M PRO DUCT_N.AME_ LOOKUP The query subject PRODUCT_N.AME_LOOKUP is on the 

many side of all its referencing relationships* 



Action 



M S.ALES„T.ARGET 



M ORDER_DET.AILS 



Issue 2 : Query subjects that can behave as facts or dimensions 




This query subject can behave as a fact or a dimension* It is recommended that you evaluate 
this query subject in the context of the model to ensure queries will not be split improperly or 
unnecessarily* More information about ambiguous cardinality*** 



Object Name Problem Description 

qOq RETAILER The query subject RETAILER is referenced by relationship ends 

of different cardinalities* 



Action 
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3 . 
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Issue 1 is "Facts identified by cardinality." You should confirm that the query 
subjects identified here are indeed facts. Both ORDER_DETAILS and 
SALES_TARGET are. But PRODUCT J^AME_LOOKUP is not a fact as 
defined by the data. EMPLOYEE_HISTORY is a factless fact, but is this how 
you want to use it for the reporting requirements, or should it be used as a 
lookup table for EMPLOYEE to return an employee's current job status? 
You'll look at these query subjects in more detail later in the course. 



Issue 2 is "Query subjects that can behave as facts or dimensions." These items 
are on the 1..1 side of at least one relationship as well as being on the l..n side 
of at least one relationship. These are also known as ambiguous query subjects. 
Before placing these in a package for reporting, you should investigate these 
objects to ensure that they do not have the potential of being used in an 
unpredictable manner. You have already seen that ORDER_HEADER may be 
used as a dimension in one query scenario and as a fact in another. 



Under Issue 2, to the right of ORDER_HEADER, click Launch Context 
Explorer 
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4. If necessary, to view all query subjects, maximize the window and click Fit All. 
The results appear similar as follows: 



EMPLOYEE 



¥ 



iff BRANCH 






BRANCH CODE 
ADDRESS1 
ADD RE SSI MB 
AD0RESS2 
ADDRESS2 MB 
CITY 
CITY MB 
FROM STATE 
FROM STATE 
POSTAL ZONE 



EMPLOYEE CODE 
FIRST NAME 
FIRST NAME UB 
LAST NAME 
LAST NAME hfi 
DATE HIRED 
TERMINATION DATE 
TERMINATION CODE 
BIRTH DATE 
GENDER CODE 




.n 



m ORDER DETAILS 

ORDER DETAIL CODE 
ORDER NUMBER 
SHIP DATE 
PRODUCT NUMBER 
PROMOTION CODE 
QUANTITY 
UNIT COST 
UNIT PRICE 
UNIT SALE PRICE 



— 




ORDER HEADER 






ORDER NUMBER 



RETAILER NAME 



RETAILER NAME MB 
RETAILER SITE CODE 
RETAILER CONTACT CODE 
SALES STAFF CODE 
SALES BRANCH CODE 



ORDER DATE 




ORDER CLOSE DATE 



ORDER METHOD CODE 



1..tn 



1..n 




11 



11 



iff RETAILER SITE 

RETAILER SITE CODE 
RETAILER CODE 
RTL AD CRESS 1 
RTL ADDRESS2 
RTL CITY 
RTL PROV STATE 

RTL POSTAL ZOfC 

RTL COUNTRY CODE 
RTL ACTIVITY STATUS CODE 
RETAILER SITE START DATE 



* 



iff ORDER METHOD 



¥ 



ORDER 

ORDER 

ORDER 

ORDER 

ORDER 

ORDER 

ORDER 

ORDER 

ORDER 

ORDER 



METHOD CODE 
METHOD EN 
METHOD FR 
METHOD CE 
METHOD NL 
METHOD JA 
METHOD SC 
METHOD KO 
METHOD CS 
METHOD HU 



Here you can quickly see how ORDER_HEADER relates to other query 
subjects and where potential problems might occur. 
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5. Close the Context Explorer and continue with the Model Advisor issues. 

Issue 3 is "Query subjects with multiple relationships." This section identifies 
query subjects that may cause ambiguous query paths. Ambiguity will be 
removed throughout the modeling process. 

6. Close the Model Advisor dialog box, and leave Framework Manager open for 
the workshop. 

Results: 

Prior to modeling the metadata, you analyzed the model for errors 
and design issues. 
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It is important to understand when query subjects are really ambiguous and how to 
solve them. 

There are logical hierarchies from SALES_REGION all the way to SALES FACT, but 
there is an ambiguous query path. 

In this scenario, multiple cardinality types attached to the query subjects is not an issue, 
but a clear query path is. 
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Business Analytics 



When is a Query Subject Really 
Ambiguous? (cont'd) 

■ IBM Cognos understands hierarchy paths 

■ In this scenario, multiple cardinality types attached do 
not present a problem because there is a clear path 
that terminates at a fact 



Aliases 




RETAILER REGION 



l..n 



1..1 



RETAILER COUNTRY 



l..n 



1..1 



RETAILER SITE 



1..1 



l..n 



BRANCH REGION 


l..n 


1..1 


BRANCH COUNTRY 


l..n 


1..1 




BRANCH 


l..i 


/1..1 

V 




Aliases 



SALES FACT 



Cognos. 

software 
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Using aliases you can remove the ambiguous query paths. 

But the query subjects still have multiple cardinalities attached. This is OK because 
IBM Cognos can traverse the hierarchies and terminate at the actual fact, in this case 

SALES FACT. 

This only becomes an issue if the hierarchy can branch off to different facts at different 
levels. You will see this example on the next page. 
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Remember querying PRODUCT_TYPE, PRODUCT, and SALES_TARGET_FACT 
caused PRODUCT to be treated as a fact query subject and generated an unwanted 
query split resulting in a full outer join? This is because IBM Cognos determined 
PRODUCT and SALES_TARGET_FACT were fact termination points and that 
PRODUCT_TYPE was a shared dimension between the two. Based on cardinality, 
this is the logical choice. But is it what you want? 

After merging PRODUCT and PRODUCT_TYPE, there is a clear hierarchy path that 
terminates at the real fact query subjects, in this case, SALES FACT and 
SALES TARGET FACT. 
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Workshop 1 : Model in Freehand to Identify Query Usage 



This workshop is based on modeling Recommendation 4: Model in freehand to 
identify query usage. 

You have just been asked to analyze a Framework Manager model based on The Great 
Outdoors Company operational database, and to make recommendations on how to 
enhance the model so that authors will achieve predictable results. 

To do so, analyze the following diagram to identify: 

• All groupings of related query structures (for example, PRODUCT_LINE, 
PRODUCT_TYPE, and PRODUCT). These can be consolidated into a single 
author- friendly model query subject for presentation 

• All facts (query subjects whose relationships are all on the l..n side) 

• Any ambiguous query subjects that can behave as either facts or dimensions 
(these can be resolved through a process of creating aliases to remove ambiguous 
query paths or by merging query subjects). 

Use the three diagrams on the following pages to identify the items in each task above. 
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Workshop 1 : Identify Groupings 
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Workshop 1 : Identify Facts 
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Workshop 1 : Identify Ambiguous Query Subjects 
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Workshop 1 : Solution 



These solutions will be explained in further detail and implemented throughout the 
next few modules. 

Groupings: 

The Identify Groupings page illustrates the first step in a star schema modeling 
solution, logically grouping related query structures: 

• SALES_REGION, COUNTRY, BRANCH, EMPLOYEE_HISTORY, 
EMPLOYEE, and POSITION_LOOKUP to make up a Staff by Location 
dimension 

• SALES_REGION, COUNTRY, RETAILER_SITE, RETAILER, and 
RET ATTE R_TYPE to make a Retailer dimension 

• PRODUCT, PRODUCTTYPE, PRODUCTJJNE and 
PRODUCT_NAME_LOOKUP to create a Product dimension 

ORDER_METHOD is a stand-alone dimension and presents no issues. 

There are also two other groupings, although not in the initial requirements, that may 
make sense. Sometimes during the modeling process the data reveals other alternatives 
that you can choose to take advantage. The ones found here are: 

• SALES_REGION, COUNTRY and BRANCH to create a Branch by 
Location Dimension, which can then link to the grouping of 

ORDER H E ADER and ORDER DET ATE S in order to identify which branch 
a sale was made from 

• SALES_REGION and COUNTRY to create a Sales T arget by Location 
dimension 

All of the above groupings will be used as dimensions to meet reporting requirements. 
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Facts: 

ORDER_DETAILS is a fact as it only has l..n cardinalities attached. 

S ATE ST ARGET is a fact as it only has l..n cardinalities attached. 

EMPLOYEE_HISTORY is also a fact even though it contains no measures. However 
the requirements for this application are to report on employees' current positions. 
Later in the modeling process, a filter will be used to filter on the current position and 
therefore change the nature of the EMPLOYEE to EMPLOYEE_HISTORY 
relationship to 1..1 to 1..1. 

PRODUCT_NAlME_LOOKUP is identified as a fact as it only has L.n cardinalities 
attached. In the data, this is not a fact and will be corrected with a filter that will change 
the cardinality to 1..1. 

Ambiguous Query Subjects: 

COUNTRY is used in multiple query paths and is a good candidate for aliasing. 

BRANCH is used in two query paths and is a good candidate for aliasing. 

ORDER_HEADER is an ambiguous query subject because it has multiple cardinality 
types attached with multiple paths. It is not part of a hierarchy with one path. 

• ORDER H E ADER is a query subject used as a bridge between most 
dimensions and the sales facts in ORDER DET ATL S. It contains keys allowing 
other dimensions to query order details. 

• ORDER_HEADER is a good candidate for merging with ORDER_DETAILS 
to create a new fact query subject. Once these two query subjects are merged, the 
new query subject will have only l..n cardinalities attached ensuring it will always 
be treated as a fact. 

RETAILER has multiple cardinality types attached and branches the hierarchy off at a 
higher level of granularity. It is a good candidate for merging with RET ATTE R STTE. 

PRODUCT_TYPE has multiple cardinalities attached and branches off at a higher 
level of granularity. It is also a good candidate for merging with PRODUCT. 
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Business Analytics 

Summary 

■ You should now be able to: 

■ identify reporting traps 

■ describe how IBM Cognos uses cardinality 

■ identify when full outer joins are appropriate 

■ use tools to analyze the model 





Cognos* 

software 
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Model for Predictable Results: 
Virtual Star Schemas 



IBM Cognos BI 




Business Analytics 
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Business Analytics 

Objectives 

■ At the end of this module, you should be able to: 

■ identify the advantages of modeling metadata as a 
star schema 

■ model in layers 

■ create aliases to avoid ambiguous joins 

■ merge query subjects to create as view behavior 



Oognos* 

software 
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Business Analytics 



Framework Manager Workflow 



Framework Manager 



Create 

Project 




Import 

Metadata 



Prepare 

Metadata 



Publish 



Set 

Security 



Model 

Metadata for 
Reporting 



I 



Create and 
Manage 
Packages 



Data 

Sources 



Content 

Store 



Report Studio 
Query Studio 
Analysis Studio 



Cognos. 

software 
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This module deals with modeling as a virtual star schema in order to ensure predictable 
results. 
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Business Analytics 



Modeling Operational vs. Reporting 
Databases 

■ Reporting databases (star schema structure) typically 



require less metadata modeling 




Operational databases typically require more of a metadata modeling effort in 
Framework Manager since they are confusing for users to understand and can present 
several reporting traps. 

This course focuses on modeling an operational source because it illustrates more 
modeling scenarios that may apply to any database, both operational and reporting. 

Star schema databases will likely require much less modeling since they are already 
designed for reporting. However, not all reporting database designs are immune to 
design issues and may require some of the very same techniques found in this course. 
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In the slide example, query subjects with dashed borders represent model query 
subjects that have been used to create views of the data at mn time. These views 
organize and/ or control the SQL generation, which helps to provide an easy to use 
model and predictable results. 

It is important to understand that modeling an operational data source as a virtual star 
schema may not meet all your business needs. However, as a general rule, it can provide 
predictable results to a broad and general audience. 

When you model an operational or reporting data source as a star schema, you are not 
changing the underlying, data structure. You are creating a virtual star schema that 
allows IBM Cognos to generate the correct SQL for predictable results. 
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Business Analytics 

What are the Advantages of Modeling 
as a Star Schema? 

■ Subject area marts (star schema groupings) 

■ Simpler for the user to understand - fewer query 
subjects 

■ Adaptable and extendable - you can easily add and 
reuse facts and dimensions 

■ Conformed dimensions prevent data silos - facts are 
related to one another through dimensions 

Coanos* 

software 
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A Presentation View contains only the star schema groupings. This logically groups 
objects appropriate for the business and easily allows you to create separate packages 
for different reporting needs. 

The decision to have another layer between the Foundation Objects View and the 
Presentation View involves several factors. For example, what is the size of the model? 
Do you need to reduce development time rather than ensure ease of maintenance later 
in the modeling cycle? 

The next three slides investigate some approaches. 



7-8 © 2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 

or translated into another language without a legal license agreement from IBM Corporation. 



MODELING FOR PREDICTABLE RESULTS: VIRTUAL STAR SCHEMAS 



Business Analytics 



Modeling in Layers: No Middle Layer 



Foundation Objects View 
contains 

■ data source query subjects 

■ model query subjects to 
resolve issues 

■ calculations and filters 
Appropriate for large projects 
Can be difficult to maintain 
Not easily portable 



Presentation View 



Foundation 
Objects View 



Oagnos. 

software 
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This method requires the least duplication of query subjects, keeping the physical size 
of the project files to a minimum. It needs less time for development, but increased 
maintenance time when in production. For example, a post-production port of the 
databases from one database vendor to another may require repairing reports. This is 
because the Presentation View objects used by report authors are shortcuts to the query 
subjects in the lower layer, which now have a new source. You will also need to 
remodel the new metadata to meet the reporting requirements. 

This method is best suited to large implementations or situations where a data 
warehouse has already been set up to accommodate the majority of the specialized 
business logic for reporting. If you expect ongoing changes to the underlying data 
structure, this may not be a suitable option. 
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Business Analytics 




Modeling in Layers: Business Logic 
View 

■ Business Logic View contains 

■ all model query subjects, 
joined with relationships 

■ all calculations and filters 

■ Provides insulation between 
data source and reports 

■ Less maintenance 

■ Portable 

■ Longer development time 

■ Larger project files and 

model Coanos. 

software 

©2010 IBM Corporation 





Creating the model query subjects (and rebuilding all their relationships) in the Business 
Logic View takes extra work but it provides a layered structure for improved model 
maintenance, readability and portability. 

An example of simpler maintenance with this layered model is a post-production port 
of the application from one database vendor to another. The existing reports are all 
based on the Business Logic View layer objects. All you have to do is re-map those 
model query subjects to the new database vendor data source query subjects. There is 
no need to rebuild the reports, or remodel the metadata. 



7-10 © 2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 

or translated into another language without a legal license agreement from IBM Corporation. 



MODELING FOR PREDICTABLE RESULTS: VIRTUAL STAR SCHEMAS 




This compromise between the previous two methods only creates model query subjects 
in the lowest layer to resolve reporting issues (this means that the model query subjects 
have relationships attached). Keeping all relationships in the lowest layer allows the 
middle layer to simply act as a consolidation layer with some business logic (where 
required) . For example, this view is where snowflake dimensions are consolidated. This 
view also acts as an insulation layer between reports and the data source. 

Calculations may appear in either the lowest or the middle layer, depending on where 
the model query subject is created. A model query subject that is created to resolve a 
reporting issue will be created in the lowest layer. Therefore, any calculations required 
for that object will be defined in the lowest layer. 
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This course will use the Consolidation View approach in the demos and workshops. In 
this module, you will focus on the early stages of the Foundation Objects View layer. 

Once the Foundation Objects View layer is completed later in the course, it will 
contain: 

• all data source query subjects 

• any model query subjects required to resolve reporting issues 

• some calculations and filters where appropriate 

The above diagram identifies, in the grey boxes (with mixed-case text), the model query 
subjects used to resolve reporting issues. Sales Fact is used to create a view of 
ORDER_HEADER and ORDER_DETAILS, thereby controlling the SQL 
generation, and all others are used to create aliases to control query paths. 
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Demo 1 : Create Alias Model Query Subjects to Avoid 

Ambiguous Query Paths 



Purpose: 

In an earlier exercise, you identified a situation where there was an 
ambiguous query path between query subjects. SALES_REGION is 
above COUNTRY in this hierarchy and therefore has the same 
ambiguous path to ORDER_ DETAILS. You will resolve the problem 
by creating aliases for SALES_REGION and COUNTRY. 



Component: Framework Manager 

Project: GO Operational 

Task 1. Review the 'ambiguous join* reporting trap. 



1 . 

2 . 

3 . 

4 . 

5 . 

6 . 



In Framework Manager, close any projects that may be open, and then open 

the GO Operational model located at C:\Edcognos\B5152\ 

CBIFM-Start Files\Module 7\GO Operational. 

If prompted, log in as User ID admin, and Password Education!.!. 

In the Project Viewer pane, in the gosales namespace, right-click 

COUNTRY, and then click Launch Context Explorer. 



If only the COUNTRY table displays in Context Explorer, click Show 
Related Objects 




Click BRANCH, and then click Show Related Objects. 

Click EMPLO YEE_H I STORY, and then click Show Related Objects. 
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If you wish, arrange the diagram as shown below to better see the hierarchy 
structure: 



yjSALES_TARGET 



SALES_YEAR 

SALES_PERIOD 
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TERMINATION_DATE 

TERMINATION.CODE 

BIRTH_DATE 

GENDER CODE 




PnC l T l AM CP 



foy BRANCH 


s 


f 


BRANCH_C0DE 


= 




^DDRESSI 






ADDRESS1.MB 






ADDRESS2 




t mm _ 


ADDRESS2.MB 




. 


CITY 




1.1 >1..n 


CITY_MB 




/ 


R£0V_STATE 






FR0V_STATE_MB 




/ 


P0STAL_Z0NE 


_ l 


> A- 


uT 







1..1 

..n 



q^EMPLOYEE.HISTORY 



SALES_REGION and COUNTRY have two separate paths that lead to 
ORDER_HEADER (or three if you include the route through 
EMPLOYEE_HISTORY and EMPLOYEE). You want to resolve ambiguity 
by creating three separate aliases of SALES_REGION and COUNTRY (so 
that each can be linked to just one of the paths to ORDER_HEADER and 
ORDER_DETAIL) . Keep the original SALES_REGION and COUNTRY to 
link to SALES TARGET. 
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You will achieve the following design at the end of this demo: 




8. Close the Context Explorer. 

Task 2. Create Region aliases as model query subjects. 

1 . In the Project Viewer pane, right-click gosales, point to Create, and then click 

Query Subject. 

2. Name the query subject Retailer Site Region (alias), and then, with Model 
selected, click OK 

3. Expand Foundation Objects View>gosales>SALES_REGION. 
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4. Add the following query items by double-clicking them. 

SALES_REGION_CODE 

SALES_REGION_EN 

This alias could also have been created by expanding SALES_REGION in the 
Project Viewer, selecting the two query items, right-clicking one of them, and 
clicking Merge in New Query Subject. Both methods have the same results. 

You will include only the columns your report authors will require. Later in the 
course, you will replace SALES_REGION_EN with a calculation that 
dynamically picks up the appropriate language column based on the language 
setting of the user's computer. 

You should rename the items to be more user-friendly before you make copies. 

5. Click OK, and then, in the Project Viewer pane, rename the query items to: 

• Retailer Site Region Code 

• Retailer Site Region 

6. Copy and paste Retailer Site Region (alias) in the gosales namespace, and 
then rename the copy to and its two query items as follows: 

• Branch Region (alias) 

o Branch Region Code 
o Branch Region 



7-16 © 2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 

or translated into another language without a legal license agreement from IBM Corporation. 




MODELING FOR PREDICTABLE RESULTS: VIRTUAL STAR SCHEMAS 



Task 3. Create Country aliases as model query subjects. 



1. Repeat Task 2 to create two aliases of COUNTRY as follows: 

• Retailer Site Country (alias) 

o Retailer Site Country Code (from COUNTRY_CODE) 
o Retailer Site Region Code (from SALES_REGION_CODE) 
o Retailer Site Country (from COUNTRY_EN) 




• Branch Country (alias) 

o Branch Country Code 
o Branch Region Code 
o Branch Country 



Drag Retailer Site Country (alias) below Retailer Site Region (alias). 



The results appear as follows: 








ggg Retailer Site Region (alias; 

Retailer Site Region Code 
Retailer Site Region 
ggg Retailer Site Country (alias] 

Retailer Site Country Code 
Retailer Site Region Code 
Retailer Site Country 
ggg Branch Region (alias] 

Branch Region Code 
Branch Region 
ggg Branch Country (alias] 
fUJl Branch Country Code 
: jjjl Branch Region Code 
Branch Country 




You now have aliases for two of the three relationships between 
Region/Country and ORDER_HEADER/ORDER_DETAILS. You will 
create the third one (for employees) in a workshop. 
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Task 4. Create relationships. 

1 . In the Project Viewer pane, select the following items: 

• Retailer Site Region (alias) > Retailer Site Region Code 

• Retailer Site Country (alias) > Retailer Site Region Code 

2. Right-click one of the selected items, point to Create and then click 

Relationship. 

The results appear as follows: 




You now have a relationship between the two query subjects on a common key 
with the correct cardinality. Again, using this method, the first object selected 
will be on the 1..1 side of the relationship. You can modify the cardinality after 
the fact if it does not meet your needs. 
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3. Click OK. 

You are asked if you would like to replicate the existing underlying relationships. 
In this case you do not want to recreate all underlying relationships since you 
only require the one you just created, which is used to control the query path 
for your alias. 

4. Click No. 

5. Repeat steps 1 to 4 to create the relationship from Branch Region (alias) (1..1) 
to Branch Country (alias) (l..n) on Branch Region Code. 

As shown in the diagram in Task 1, you also want to create relationships 
between your COUNTRY aliases and the query subjects that lead them to 
ORDER_HEADER, RETAILER_SITE and BRANCH respectively. 

6. Repeat steps 1 to 3 to create the following relationships: 

• Retailer Site Country (alias) (Retailer Site Country Code, 1..1) to 
RETAILER_SITE (RTL_COUNTRY_CODE, l..n) 

• Branch Country (alias) (Branch Country Code, 1..1) to 
BRANCH (COUNTRY_CODE, l..n) 

Task 5. Remove old relationships. 

1 . Right-click COUNTRY, click Launch Context Explorer, and then click 

Show Related Objects. 

COUNTRY should no longer link to RET ATT ER_STTE or BRANCH, now 
that Retailer Site Country (alias) links to RET ATTE R STTE and Branch 
Country (alias) links to BRANCH. 

2. Delete the relationship between the following items: 

• COUNTRY and RETAILER_SITE 

• COUNTRY and BRANCH 

3. Close Context Explorer. 
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4 . 

5 . 



Click Diagram on the right side of the screen. 



In the Diagram, arrange the objects as shown below: 




m Retailer Site Region [alias} 



Retailer Site Region Code 
Retailer Site Region 



CI 



□□□ Retailer Site Country alias) 



Retailer Site Country Code > 1 
Retailer Site Region Code 



RETAILER SUE 



RET AILER 5ITECQDE 

RE TA1LERC ODE 

RTL_ADDRESS1 

RTL_ADDRESS2 

RTLCITY 

rr, 



Ho Branch Region [alias) 


E ranch Region Code 




Branch Region 





BRANCH 



BRANCHJCODE 

ADDRESS! 

ADDRESSLME 

ADDRESS2 

ADDRES82_ME 

CITY 



ORDER HEADER 



OR DER_NU MEIER 
ETAILER_NAME 
ETA ILERN A M E_M E 
RETAILERSITECODE 
R ET Al LE R_C ONTAC T_C O D E 
SALES STAFF CODE 



m B ra nc h Co ui ntry [alias) 


3 


Branch Country Code . 




Branch Region Code 


▼ 


Branch Country 





SALES REGION 



SALE S_R EGION_COD E 
SALES REGION EN 



COUNTRY 



POSU 



POSIT ION J 
POSITION E 



COUNTRY_CODE 
■COUNTRY EN 



EMPLOYEE HISTO 



E M F LOYE E_H I ST QRYjCOI 
EM PLOYEE J-1 1ST ORYJPAF 
EMPLOYEE CODE 





IB ORDERJETH0D 






R ECC'R D_START_D ATE 




OR D E R_M ET HGDjCOD E 


£91 


V In 


R ECC'R D_E N D_D AT E 




OR D E R_M ETHOD_E N 




POSITION CODE 




or nr r uFTT-inn fb 


Q 




position_start_date 



EMPLOYEE 

EM FLOYEECODE 
FIRST_NA.ME 
FIRST_NAME_ME 
LAST NAME 



MANAGE R_CODE 
MANAGER 
MANAGER ME 



SALES TARGET 



SALES_YEAR 
SALES PERIOD 



SALES_REGION and COUNTRY no longer have ambiguous query paths. 
There is now a clear path for retailer queries, branch queries and sales target 
queries. 



6. Save the project and leave Framework Manager open for the next demo. 



Results: 

You have taken the first steps to resolving a situation where the 
proper relationship between SALES_REGION/COUNTRY and 
ORDER_HEADER/ORDER_DETAILS could be ambiguous. You have 
created multiple copies of the ambiguous query subjects and 
relationships among them. 
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In the example above, the IBM Cognos query engine can identify ORDER_H E ADER 
as a fact or as a dimension depending on the query in which it is used. This is because it 
has a mix of cardinalities attached to it and contains descriptive information that could 
be used inappropriately. 

ORDER_HEADER is closely related to ORDER_DETAILS and is part of the path 
for related dimensions, such as EMPLOYEE, in the majority of queries using 

ORDER_DETAILS. 

You can merge ORDER_HEADER and ORDER_DETAILS, keeping only required 
query items, to remove this ambiguity. 
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Business Analytics 

Create "As View" Behavior 



■ Merging query subjects with relationships creates "As 




©2010 IBM Corporation 



By merging ORDER_H E ADER and ORDER DET ATE S and maintaining existing 
relationships, you create "As View" behavior in which the underlying join between 
ORDER_HEADER and ORDER_DETAILS is always honored. In this way, these 
two query subjects will always be treated as one, and in this case, always as a fact. 
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Business Analytics 



Requirements Review 



Recommendation #1 




Cognos 

software 
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In the next demo, you will create a model query subject to meet your Sales Fact 
requirement. 
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Demo 2: Create a Sales Fact Model Query Subject 



Purpose: 

You have resolved the ambiguous relationship between 
SALES_REGION/COUNTRY and ORDER_DETAILS by creating 
aliases of SALES_REGION and COUNTRY as model query subjects. 
To further simplify the model and remove ambiguity, you will now 
create a Sales Fact model query subject that merges 
ORDER_HEADER and ORDER_DETAILS into one model query 
subject. This is done to ensure that the query path through 
ORDER_HEADER is maintained when reporting on sales figures and 
to remove the ambiguity that ORDER_HEADER presents. 



Component: Framework Manager 

Project: GO Operational 

Task 1 . Create a Sales Fact model query subject. 

1 . In the Project Viewer pane, select ORDER_HEADER and 
ORDER_DETAILS, right-click one of the selected items, and then click 

Merge in New Query Subject. 

You are asked if you would like to recreate existing relationships. 

2. Click Yes. 

You want all the relationships recreated because this is a fact query subject that 
connects to many dimensional query subjects. You did not want to recreate 
relationships when creating aliases earlier, because you were specifically creating 
new relationships to avoid ambiguous query paths. 

By merging these two objects and maintaining relationships, the query subject 
will behave as a view and always generate the underlying join between the two 
query subjects. This will be examined in more detail later in the course when 
exploring SQL generation. 
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3. Rename the new model query subject to Sales Fact. 

4. Double-click Sales Fact to open its Query Subject Definition dialog box. 

5. Delete the following query items: 

RETAILERNAME 

RETAILERNAMEMB 

ORDER_NUMBERl 

By deleting the retailer names, you are preventing authors from accessing the 
incorrect version of the retailer name and inadvertently taking descriptive 
information from a fact query subject. 

ORDER_NUMBERl is a redundant query item merged in from 
ORDERJDETAILS. You will use ORDER_NUMBER from 
ORDER HEADER. 
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6 . 
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Click OK, and then rename the measure query items as follows: 

• Quantity 

• Unit Cost 

• Unit Price 

• Unit Sale Price 



The results appear as follows: 



-]■ Sales Fact 




Qgl ORDER NUMBER 




'1 


| R ETAI LER_S ITE_C0 D E 




1 


| RETAILER_CONTACT_CODE 




1 


| SALES_STAFF_CODE 




J 


| SALES_BRANCH_CODE 




-I® ORDER DATE 
-Dgl ORDER CLOSE DATE 
•DS1 ORDER METHOD CODE 
.■DJI ORDER DETAIL CODE 
^ SHIP DATE 




IH 


fl P ROD UCTJM UMBER 




1 


| PROMOTION_CODE 




[J2J Quantity 

[]|L Unit Cost 

[]jL Unit Price 

[Hl Unit Sale Price 



These are the query items that will eventually be used in the Presentation View 
which your authors will see. 
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Task 2. Test "As View" behavior. 

1. Test the Quantity query item, and then view the Query Information tab. 

The results appear as follows: 

Cog nos SQ L 

select 

S al e s__Fa e t . Quan t i ty a s Quan t i t y 

from 

(select 

ORDER_DE TAI LS . QUANT I T Y as Quau t i ty 

from 

GO S A LE S . GO S A LE S . go s ale s . GRDER_KEADER ORDER_HEADER P 
GOSALES ■ GO SALES . go sales ■ ORDER DETAILS ORDER DETAILS 

I wtiere 

(ORDER HEADER .ORDER NUMBER = ORDER DETAILS ■ ORDER NUMBER) 

| } Sales_Fact 

Although you selected an item only associated with ORDER_DETAILS, a join 
with ORDCRH E ADER is honored as seen in the where clause. The two 
underlying query subjects are now treated as one. 

2. Click Close. 

You will now quickly test the behavior of a merged query with no relationships 
attached. 

3. In the Project Viewer pane, select ORDER_HEADER and 

ORDER_DETAILS, right-click one of the selected items, and then click 

Merge in New Query Subject. 

You are asked if you would like to recreate existing relationships. 

4. Click No. 
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5. Expand ORDER_HEADER_ORDER_DETAILS, test QUANTITY, and 
then click the Query Information tab. 

The results appear as follows: 




There is no join with ORDER_H E ADER. This new query subject is simply 
acting as a container for the two underlying query subjects. Since you only 
queried an item from ORDER_DETAILS, the SQL is minimized and only 
requests information from that one table in the database. 

6. Click Close, and then click Undo on the toolbar to remove the new query 
subject. 

Task 3. Organize gosales namespace and reduce model 

clutter. 

As a convention, you will sort your project objects alphabetically, but place all 
facts before all dimensions. 

1. In the Project Viewer, right-click the gosales namespace, and then click 

Reorder. 

2. Ensure Ascending is selected, and then click OK. 
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3. Drag Sales Fact to the top in the gosales namespace, and then drag 

SALES TARGET below Sales Fact. 



The results appear as follows: 



Project Viewer 




GO Operational 

GO Operational Model 



^ Foundation Objects View 1 



gosales 



B offi Sales Fact 
E| jjjg SALES_TARGET 
± S BRANCH 



ww\\ Branch Country (alias; 

+ [jfjg Branch Region (alias) 

+ ^COUNTRY 
|| |S EMPLOYEE 
+ |S EMPLOYEE HISTORY 
|i] 0RDERJ3ETAILS 

+ [gfl ORDER_HEADER 
+ [jj| ORDER_METHOD 
+ POSITIONJJDOKUP 

+ PRODUCT 

+ PRODUCT_LINE 

jl |S PROD UCT_NAME_LOOKUP 
+ |S PRODUCT_TYPE 
± m RETAILER 



a- WUU R^ailer Site Country (alias) 
0- [jfjf] Retailer Site Region (alias) 
+ n|g RETAILER_SITE 
$ IS RETAILER_TYPE 
i SALES_REGION 



Original data source query subjects that have been replaced by model query 
subjects (in order to prevent reporting traps) will be placed in a separate folder 
and non-required relationships will be deleted in order to reduce model clutter. 



You will do this now for ORDER_HEADER and ORDERJDETAILS. 
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4. Right click the gosales namespace and choose Create 
Original Sales Objects, and then click Next. 

5. Expand Foundation Objects View > gosales, select 

ORDER_DETAILS and ORDER_HEADER. 

They will change to green checks. 

6. Click Finish. 

7. Expand Original Sales Objects, select ORDER_HEADER and 
ORDER_DETAILS, right-click one of the selected items, and then click 

Launch Context Explorer. 

8. Click Show Related Objects, and then delete all relationships except the one 
between ORDER_HEADER and ORDER_DETAILS. 

The results appear as follows: 



9. 

10 . 
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ORDER HEADER 



EMPLOYEE 



¥ 



BIRTH _DATE 
DATEJHIRED 
EMAIL 

EMPLOYEE CODE 



¥ 



OR D E R_C LOS E_DAT E 

ORDER JDATE 

OR D E R_M ET HODjCOD E 

ORDER.NUMEER 

R ET Al LE R_CONT ACT.COD E 

RETAILERNA ME 

R ET Al LE R_N AM E_M B 

i~i.i — r ft u r.n aUBC QflBC 



1.1 



BRANCH 



AD DRESS 1 

ADDRESS 1_MB 

ADDRESS2 

ADDRESS2_MB 

BRANCH_CODE 

CITY 



1..n 



ORDER DETAILS 



& 



OR D E R_D ET Al L_COD E 
OR DER_NU M BER 
PRODUCT NUMBER 



UNIT JPR ICE 
UNIT SALE PRICE 



PROMOT ION_COD E 




BBi 1 0RDER_METH0D 


•QUANTITY 




OR D E R_M ETHOD_COD E 


SHIP_DATE 




OR D E R_M ET HODjCS 


UNIT_COST 




ORDER LiPTHnn na I B 



¥ 



RETAILER SITE 



¥ 



RETAILER_CODE 
R ET Al LE R_S ITE_COD E 
R ET Al LER_S ITE_ST ART_D AT E 
RTL_ACT I VITY_ST ATUSjCOD E 
RTL ADD RES SI 






PRODUCT 



¥ 



BASE_PROD UCTJN UMBER 
D I SCC'NT I N U E D_DAT E 
GROSS MARGIN 



■ 



Close the Context Explorer. 

Save your project. 



> Folder, and name it 
the X next to 
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Task 4. Test your new virtual star schema query subjects 

(optional). 

Recall the Ambiguous Relationships demo in the Identify Reporting Issues 
module. An author was asked to create a query with COUNTRY_EN and 
QUANTITY, but there was more than one path between the data source query 
objects and so there was potential for unexpected results. 

Now authors must explicitly take the country name from either Retailer 
Country (down one path) or Branch Country (down another path), depending 
on whether they want the countries of the clients (retailers) or of the sales 
offices (branches) . The results are always expected and predictable. 

1 . Select and test the following query items with Auto Sum enabled: 



Query Subject 


Query Item 


Retailer Site Country (alias) 


Retailer Site Country 


Sales Fact 


Quantity 



The goal is to report on the number of units sold to each retailer's country. 
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2. Click the Query Information tab. 

The results appear as follows: 

Cog nos S QL 

select 

Re tails r_S i te_C on it t ry al i as_ . Re tails r_S i te_C one t ry as Re tails r_S i t e_C oim t ry , 

XSUM { S ale s Fac t . Qaan t i ty f o r Re t a i ler_S i te_C odd t ry al i a s_ . Re t al Is r_S i te_C onn t ry > as 

from 

{select 

COUNTRY . COUNTRY_C ODE as Re taile r_S i t e_C one t r y_C ode , 

COUNTRY . COUHTRYEN as Re t a 1 le r_S i te_C onn t ry 

from 

GOSA LE S . GOSA LES.gos ale s . COUNTRY COUNTRY 
) Re taile r_S i t e_C onn t r y al i as _ , 

{select 

ORDER_HEADER . RE T AI LER_S 1 TEOODE as RE T AI LER_S I TECODE r 
ORDER_DE T AI LS . QUANT I T Y as Quail 1 1 ty 

from 

GOSA LE S . GGSALE S . go sales . ORDER_HEAUER ORDERHEADER r 
GOSA LE S . GOSA LE S . go sales. ORDER_DE T AI LS ORDER_DE T AI LS 

where 

{ORDER HEADER . ORDER MUHBER = ORDERDE T AI LS . ORDER NUHBER ) 

) Sales_Fact P 

I where 

{Ret ai le r_S 1 te_C onn t ry al 1 as_ . Re t ai le r_S i te_C onn t ry_C ode = RE T AI LER_S I TE . RT L_C 0UNTRY_C 01 

gronp by 

Re taile r_S i t e_C onn t ry al i as_ . Re taile r_S i t e_C onn t ry 

Notice the final where clause. The query takes the path you expected, Retailer 
Country (alias) to RETAILER_SITE to Sales Fact. This query works because 
the model has no alternative query paths. You have removed any ambiguity. 
The same concept would apply if you tested Branch Country (alias) and Sales 
Fact. 

3. Click Close, save the project, and leave Framework Manager open for the 
Workshop. 

Results: 

To remove ambiguity that may occur with the ORDER_HEADER data 
source query subject, you merged ORDER_HEADER with 
ORDER_DETAILS. You then organized your model and reduced 
clutter and tested your new alias query subjects with the new Sales 
Fact query subject to ensure ambiguity has been removed. 
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Workshop 1 : Create Staff-Related Model Query Subjects 



In the last two demos, you wanted report authors to avoid accidentally choosing the 
wrong path between SALES_REGION / COUNTRY and 
ORDER_HEADER/ ORDER_DETAILS, so you created two aliases of 
SALES_REGION and COUNTRY, one for retailer sites and one for branches. You 
also, merged ORDER_HEADER and ORDER_DETAILS into a Sales Fact model 
query subject. 




However, BRANCH links to Sales Fact in two paths; direcdy, as well as through 
EMPLOYEE HISTORY and EMPLOYEE. 
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Create a third alias for SALES_REGION and COUNTRY as follows: 

• Staff Region (alias) 

o Staff Region Code (from SALES_REGION_CODE) 
o Staff Region (from S. A T ES_R EGTON EN) 

• Staff Country (alias) 

o Staff Country Code (from COUNTRY _CODE) 

o Staff Region Code (from S AT ES REGTON CODE) 

o Staff Country (from COUNTRY_EN) 

Create a relationship between Staff Region (alias) and Staff Country (alias) . 

You also need a relationship from Staff Country (alias) to BRANCH, but Branch 
Country (alias) already has a join to BRANCH. To avoid ambiguity, you first need to 
create an alias for BRANCH. 

• Create a new model query subject called Staff Branch (alias), with the following 
query items (taken from BRANCH and renamed): 

o Staff Country Code 
o Staff Branch Code 
o Staff Addressl 
o Staff Address2 
o Staff City 
o Staff Prov / State 
o Staff Postal Zone 

• Create a relationship between Staff Country (alias) (Staff Country Code, 1..1) 
and Staff Branch (alias) (Staff Country Code, l..n). 
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STAR SCHEMAS 



• Create a relationship between Staff Branch (alias) (Staff Branch Code, 1..1) and 
EMPLOYEE_HISTORY (BRANCH_CODE, l..n). 

• Delete the relationship between the original BRANCH and 
EMPLOYEE HISTORY. 



The results should look as follows: 




Remember to manually sort your new objects alphabetically and arrange your diagram 
to show the new staff query path from region through to EMPLOYEE_HISTORY. 

For more detailed information outlined as tasks, see the Task Table on the next page. 
For the workshop results, see the Workshop Results section that follows the Task Table. 



©2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 
or translated into another language without a legal license agreement from IBM Corporation. 



7-35 



IBM COGNOS FRAMEWORK MANAGER: DESIGN METADATA MODELS (V10.1) 



Workshop 1: Task Table 



Task 


Where to Work 


Hints 


1 . Create Staff Region 
(alias) and Staff 
Country (alias). 


Project Viewer 


• Make copies of Branch Region 
(alias) and Branch Country (alias) 
and rename objects as follows: 

Staff Region (alias) containing 
Staff Region Code and 
Staff Region 

Staff Country (alias) containing 
Staff Country Code and 
Staff Region Code and 
Staff Country 

Tip: Select original objects to copy 
and paste. This will also copy the 
relationship between the new 
objects. 


2. Create Staff Branch 
(alias) model query 
subject. 


Project Viewer, 
Query Subject 
Definition dialog 
box 


• Create a new model query subject 
called Staff Branch (alias) in the 
gosales namespace. 

• Contents (after renaming), from 

BRANCH: 

Staff Country Code 
Staff Branch Code 
Staff Address 1 
Staff Address2 
Staff City 
Staff Prov/ State 
Staff Postal Zone 
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Task 


Where to Work 


Hints 


3. Create branch 
relationships. 


Project Viewer, 
Relationship 
Definition dialog 
box 


• Do not replicate underlying 
relationships. 

• Staff Country (alias) (1..1) to Staff 
Branch (alias) (l..n) on Staff 
Country Code 

• Staff Branch (alias) (1..1) to 
EMPLOYEE_HISTORY (l..n) on 
Staff Branch Code = 
BRANCH_CODE 


4. Delete unwanted 
relationship. 


Project Viewer, 
Context Explorer 


• Delete the relationship between the 
original BRANCH and 
EMPLOYEE_HISTORY, and 
between BRANCH and Staff 
Country (alias). 


5. Organize your 
project. 


Project Viewer, 
Diagram 


• Organize the new model query 
subjects manually so that they are 
listed alphabetically in the gosales 
namespace. 

• Arrange your diagram to clearly 
show the new path created for staff 
information. 

• Save and leave the project open for 
the next workshop. 
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Workshop 1 : Workshop Results 



Your Foundation Objects View should include the new objects shown below: 














ODD 



BBB Staff Branch (alias) 

Staff Country Code 
Staff Branch Code 
Staff Address 1 
Staff .Address 2 
Staff City 
Staff Prov/State 
Staff Postal Zone 
BBB Staff Country (alias) 

Staff Country Code 
Staff Region Code 
Staff Country 
BBB Staff Region (alias) 

Staff Region Code 
Staff Region 








m 



I I I r I l'~'l ri i~i i i~. -=i 
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Workshop 1 : Workshop Results 



Your Diagram should be organized to show the new staff query path. 
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Workshop 2: Merge Query Subjects to Remove Ambiguity 



Based on the modeling in the freehand exercise, it was determined that both 
PRODU CT_TYPE and RETAI L ER had the potential to be ambiguous query 
subjects. 

To remove their ambiguity, you will merge them with other query subjects. 

• PRODU CT_TYPE will be merged with PRODUCT, say yes to recreating 
relationships, rename the new query subject to Product Type & Product, and 
remove any redundant query items 

o Move original query subjects into a new folder called Original Product 
Objects and delete all relationships to them except the one between each 
other 

• RETAILER will be merged with R ETA I T E R_SITE, say yes to recreating 
relationships, rename the new query subject to Retailer & Retailer Site, and 
remove any redundant query items 

o Move original query subjects into a new folder called Original Retailer 
Objects and delete all relationships to them except the one between each 
other 

Arrange the new model query subjects alphabetically. 

For more detailed information outlined as tasks, see the Task Table on the next page. 

For the workshop results, see the Workshop Results section that follows the Task 
Table. 
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Workshop 2: Task Table 



Task 


Where to Work 


Hints 


1 . Merge product 
query subjects. 


Project Viewer, 
Diagram or Context 
Explorer 


• Merge PRODUCTTYPE and 
PRODUCT and say yes to 
recreating relationships 

• Rename to Product Type & 
Product 

• Delete 

PRODU CT_TYPE_CODEl 

• Move PRODUCT_TYPE and 
PRODUCT to a new folder called 
Original Product Objects in the 
Foundation Objects View/ gosales 

• Delete all relationships to 
PRODU CT_TYPE and 
PRODUCT except the relationship 
between PRODUCT_TYPE and 
PRODUCT 

• Arrange new model query subject 
alphabetically 
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Task 


Where to Work 


Hints 


2. Merge retailer 
query subjects. 


Project Viewer, 
Diagram or Context 
Explorer 


• Merge RETAILER and 

RET A1LER_S1TE and say yes to 
recreating relationships 

• Rename to Retailer & Retailer Site 

• Delete RETAILER_CODEl 

• Move RETAILER and 

RET AILER_SITE to a new folder 
called Original Retailer Objects in 
the Foundation Objects 
View/ gosales 

• Delete all relationships to 
RETAILER and 

RET ATTER_STTE except the 
relationship between RETAILER 
and RET ATT ER_STTE 

• Manually arrange new model query 
subject alphabetically 

• Save and close the project 



7-42 © 2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 

or translated into another language without a legal license agreement from IBM Corporation. 












MODELING FOR PREDICTABLE RESULTS: VIRTUAL STAR SCHEMAS 



Workshop 2: Workshop Results 



Your Foundation Objects View should include the new objects and folders shown 
below: 



^§1 Foundation Objects View 




gosales 

+]■ Sales Fact 
& H8 SA.LES_TA.RGET 
BRANCH 

III Branch Country (alias] 
III Branch Region (alias] 
COUNTRY 
EMPUDYEE 
EM P LD YEE_HISTO R Y 
ORDER_METHOD 
FOSIHON_LOOKUP 
PRODUCT LINE 














Product Type 3 Product | 


LJE 


Retailer 3 Retailer Site | 

|—b ■ -1 si"- ■ 1- Sb 




III Retailer Site Region (alias] 
RETAILERJTYPE 
SALES_REGION 
III Staff Branch (alias] 

[jjjfl Staff Country (alias) 
nfin Staff Region (alias) 




^^^^Origina^roduc^biect^^l 




PRODUCT 

hrttf PRODUCT TYPE 



^^^^Origina^etaile^biects 




IS 



a 



RETAILER 
RETAILER_SITE 
Original Sales Objects 
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Business Analytics 

Summary 

■ You should now be able to: 

■ identify the advantages of modeling metadata as a 
star schema 

■ model in layers 

■ create aliases to avoid ambiguous joins 

■ merge query subjects to create as view behavior 



Oognos, 

software 

©2010 IBM Corporation 
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Model for Predictable Results: 
Consolidate Metadata 
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Business Analytics 
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Business Analytics 

Objectives 

■ At the end of this module, you should be able to: 

■ create virtual facts to simplify writing queries 

■ create virtual dimensions to resolve fact-to-fact 
joins 

■ create a consolidated modeling layer for 
presentation purposes 

■ consolidate snowflake dimensions with model 
query subjects 

■ simplify facts by hiding unnecessary codes 

Coanos* 

software 

©2010 IBM Corporation 
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Business Analytics 



Framework Manager Workflow 



Framework Manager 



Create 

Project 




Import 

Metadata 



Prepare 

Metadata 



Publish 



Set 

Security 



Model 

Metadata for 
Reporting 



I 



Create and 
Manage 
Packages 



Data 

Sources 



Content 

Store 



Report Studio 
Query Studio 
Analysis Studio 



Cognos. 

software 
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This module deals with creating a Consolidation View in which model query subjects 
are used to create a layer of consolidated metadata to be presented to authors. This 
layer will insulate reports from changes to the underlying data source. 
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Business Analytics 



Requirements Review 



Recommendation #1 




Cognos 

software 
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In the next demo, you will import returns metadata and then model accordingly to 
meet the reporting requirements - the ability to report on returns against all the 
dimensions listed. 
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Business Analytics 






i = == 


Examine Returns Data 




■ In the data source returns are related to order details, 
and not the required dimensions for reporting 




ORDER_DETAILS 


1..1 


RETURN ED_ITEM 






0..n 












Cognos 

software 
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The nature of the data does not currently let you direcdy report returns by staff, order 
method, or product. 

You will need to use modeling techniques to make returns fact data appear direcdy 
related to the required dimensions. 
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Business Analytics 



Create Virtual Facts 



Recommendation #5 



■ Returns Fact needs the same relationships as Sales 
Fact. 




Cognos, 

software 
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Because returns are so closely related to orders, they should have the same relationships 
to dimensions as orders. This is to provide authors with the ability to write logical 
reports, for such things as "which products were returned", without having to include 
order information to get results for returns. 

You can create a model query subject to include all the keys required to create 
relationships between Returns Fact and all the required dimensions. This makes the 
new model query subject appear like a virtual fact table as seen in a star schema data 
warehouse. Keys will be hidden so that only facts are visible to authors. 
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Purpose: 

Report authors would like to create reports on returns (such as how 
many returns are on a particular product) without having to 
explicitly include Sales Fact to get the correct results. This can be 
done through a Returns Fact, which will also fit the goal of modeling 
as a virtual star schema. You can create relationships between this 
fact and other dimensional model query subjects. 

Component: Framework Manager 

Project: GO Operational 

Taskl. Import returns metadata. 

1. In Framework Manager, close any projects that may be open, and then open 

the GO Operational model located at C:\Edcognos\B5152\CBIFM-Start 
Files\Module 8\GO Operational. 

2. If prompted, log in as User ID admin, and Password Education!.!. 

3. In the Project Viewer pane, right-click the gosales namespace, and then click 

Run Metadata Wizard. 

4. Ensure that Data Sources is selected, and then click Next. 

5. Ensure GOSALES is selected, and then click Next. 

6. In the list of objects, expand GOSALES>Tables, and then select 

RETURNED_ITEM and RETURN_REASON. 

7. Click Next. 

8. On the Generate Relationships page, select Both. 
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MODELING FOR PREDICTABLE RESULTS: CONSOLIDATE METADATA 



9. Click Import, and then click Finish. 

10. Expand the two new data source query subjects to view their contents. 

RETURNED_ITEM will be used to create Returns Fact and 
RETURN_RE AS ON will be used as a dimension to provide context to returns. 

You are now ready to create a new virtual fact by combining query items from 
several data source query subjects into one model query subject. 

Task 2. Build the Returns Fact. 

1. In the gosales namespace, create a new model query subject called Returns 
Fact, and then click OK. 

2. In the Query Subject Definition, expand Foundation Objects View> 
gosales, and RETURNED_ITEM, and then add the following query items 
to the definition: 



Query Subject 


Query Item 


RETURNED_ITEM 


RETURN_CODE 

RETURN_DATE 

ORDER_DETAIL_CODE 

RETURN_REASON_CODE 


ORDER_HEADER 


RETAILER_SITE_CODE 
SAT FA ST AFF COPE 

sales_branch_code 

ORDER_METHOD_CODE 


ORDER_DETAILS 


PRODUCT_NUMBER 


RETURNED_ITEM 


RETURNQUANTITY 
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3. Click OK, expand Returns Fact, and then rename RETURN_QUANTITY 
to Return Quantity. 

4. Drag Returns Fact to just below SALES_TARGET, and then drag 

RETURN_REASON below RET ATT ERTYPE 

You now have three query subjects for facts (Sales Fact, S AFE S T ARGET, 
and Returns Fact), followed by all the query subjects for dimensions. 

5. Drag RETURNED_ITEM to the Original Sales Objects folder, and then 
rename the folder to Original Sales & Returns Objects. 

Task 3. Build relationships. 

1. Create the following relationships, clicking No if asked to replicate the existing 
underlying relationships: 

• RETURNJREASON (RETURN_REASON_CODE, 1..1) to 
Returns Fact (RETURN_REASON_CODE, l..n) 

• ORDER_METHOD (ORDER_METHOD_CODE, 1..1) to 
Returns Fact (ORDER_METHOD_CODE, l..n) 

• Product Type & Product (PRODUCT_NUMBER, 1..1) to 
Returns Fact (PRODU CT_NUMBER, l..n) 

• EMPLOYEE (EMPLOYEE_CODE, 1..1) to 
Returns Fact (SALES_STAFF_CODE, l..n) 

• Retailer & Retailer Site (RET ATTE R_STTE_CODE, 1..1) to Returns 
Fact (RET A TT E R_STTE_COPE, l..n) 

• BRANCH (BRANCH_CODE, 1..1) to Returns Fact 
(SALES_BRANCH_CODE, l..n) 
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2. Launch Context Explorer from Returns Fact, and then click Show Related 
Objects. 

3. Click Auto Layout, ensure Layout Style is set to Star, and then click Apply. 

4. Click Close. 



The results appear as follows: 




Notice that Returns Fact appears in a star schema in which the fact query 
subject is surrounded by its related dimensions. 

Note: The placement of the related dimensions may display in a different order. 
5. Close Context Explorer. 
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Task 4. Delete redundant relationship. 

The original RETURNED_ITEM has a relationship to RETURN_REASON. This 
relationship is no longer required since the new Returns Fact model query subject now 
has a relationship to RETURN_REASON. 

1 . Right-click RETURN_REASON, and then click Launch Context Explorer. 

2. Click Show Related Objects, and then delete the relationship between 

RETURN_REASON and RETU RN_ITE M . 

3. Close Context Explorer, and then save the project. 

Results: 

Report authors would like to create reports on returns (such as how 
many returns are for a particular product) without having to 
explicitly include Sales Fact to get the correct results. This was 
done by creating a Returns Fact, as well as relationships between 
this fact and other dimension model query subjects. 
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Business Analytics 



Recommendation #5 



Create Virtual Dimensions 

■ Add dimensional query items from ORDERJHEADER and 
ORDER DETAILS to create Order Codes. 



ORDER DETAILS 




ORDER HEADER 


1 ORDER DETAIL CODE 1 

“or d"e fT nuiTber A 

SHIP_DATE 
PRODUCT_NUMBER 
Quantity 
Unit Cost 


■order "NUMBER 2 
Retailer name 
/retailer name mb 

' RETAILER SITE CODE 
RETAILER CONTACT CODE 
SALES STAFF CODE 






Order Codes 



Order Number 
Order Detail Code 



Conformed Dimension 



Sales Fact 




Returns Fact 



Coanos. 

software 
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Certain non-fact query items from fact tables can be placed in a model query subject to 
ensure that they are viewed as coming from a dimension by IBM Cognos. 

For example, ORDER_NUMBER and ORDER_DETAIL_CODE are required for 
reporting purposes and are located in ORDER_HEADER and ORDER_DETAILS 
respectively. By placing these query items in a new model query subject called Order 
Codes, you create a query subject that acts like a virtual dimension table as seen in a star 
schema data warehouse. This ensures that the dimensional query items are not missing 
from the final model presentation. 

In the underlying data source, the only way to query returns is through 
ORDER_DETAILS, which is a fact-to-fact join. Once created, the Order Codes query 
subject can act as a conformed dimension between Sales Fact and Returns Fact. 
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Workshop 1 : Create a Virtual Dimension 



Analyzing the model design for flexibility, you see two reasons to create an Order 
Codes dimensional model query subject. First, it creates a virtual dimension that 
ensures that dimensional query items in ORDER_DETAILS and ORDER_HEADER 
are available in a dimension. Second, it allows report authors to stitch together queries 
on Sales Fact and Returns Fact in a single report, by using it as a conformed dimension. 

Create this virtual dimension as follows: 

• Create an Order Codes model query subject containing 
ORDER_DETAIL_CODE from ORDERJDETAILS and 
ORDER_N UMBER and from ORDER_HEADER. 

• Form relationships from Order Codes to both Sales Fact and Returns Fact on 
the order detail code. 

• Test the use of Order Codes as a conformed dimension. First, do a Test on Sales 
Fact>ORDER_NUMBER, Sales Fact> Quantity, and Returns Fact>Return 
Quantity. Then compare the results to a Test on Order Codes>Order Number, 
Sales Fact> Quantity, and Returns Fact>Return Quantity. 

• Compare the SQL between the two tests. 

For more detailed information outlined as tasks, see the Task Table on the next page. 

To see the desired queries and model query subject contents, see the Workshop Results 
section that follows the Task Table. 
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Workshop 1: Task Table 



Task Where to Work Hints 

1. Create a new model Project Viewer • Right-click gosales, Create > Query 

query subject. Subject 

• Name it Order Codes 

• Include ORDER_HEADER> 
ORDER_N UMBER and 
ORDER_DETAILS > 
ORDER_DETAIL_CODE. 

• Rename the query items to Order 
Number and Order Detail Code. 

• Drag Order Codes to just below 
EMPLO YEE_HIST ORY to keep 
alphabetical order 

2. Create relationships Project Viewer, • Reply No if asked to replicate the 

for Order Codes. Relationship existing underlying relationships 

Definition dialog box 

• Order Codes (Order Detail Code, 
1..1) to Sales Fact 

(ORDER JDETAIL_CODE, l..n) 

• Order Codes (Order Detail Code, 
1..1) to Returns Fact 
(ORDER_DETAIL_CODE, l..n) 

• Arrange Order Codes 
alphabetically, and then save the 
project 
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Project Viewer, Test 
Results 
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3. Test Order Codes 
as a conformed 
dimension. 



• Do a Test with Auto Sum enabled 
on Sales Fact 

> ORDER_NUMBER, Sales Fact 

> Quantity, and Returns Fact 

> Return Quantity 

• View the SQL 

• Do a Test with Auto Sum enabled 
on Order Codes>Order Number, 
Sales Fact > Quantity, and Returns 
Fact>Return Quantity 

• View the SQL 
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Workshop 1 : Workshop Results 



Your Foundation Objects View should appear as shown below: 



Foundation Objects View 



°^| gosales 
Hg Sales Fact 
Djj§ S ALES_T ARG ET 
Hg Returns Fact 
BRANCH 




+ ODD 

+ m 




+ - 




+ 




□□□ 






Branch Country (alias) 

Branch Region (alias) 
COUNTRY 
EMPLOYEE 
EMPLOYEES ISTORY 
Order Codes 
[[JJl Order Number 
[^l Order Detail Code 
DRDER_METHOD 
PQS ITIO N_LDD KU P 
PRODUCTJJNE. 

PROD UCT_NAM EJLGOKUF 
Product Type & Product 
Retailer 3 Retailer Site 
Retailer Site Country (alias) 
Retailer Site Region (alias) 
RETAILER.TYPE 
RETURN_REASON 
SALES REGION 



E gag Staff Branch (alias) 

BBB Staff Countr>' (alias) 

[f] BBB Staff Region (alias) 

Q] Original Product Objects 

0 Q Original Retailer Objects 

Original Sales 3 Returns Objects 
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Workshop 1 : Workshop Results 



SQL for the first test without Order Codes appears as shown below: 



Cog nos SQL 



select 

D2 . Q'RDER_NUMBER as QRDER_NUMBER P 

D 2 . Quail t i ty as Qaaa t i ty r 

D 3 . Re turn_Qaan t i ty as Re tum_Quan t i ty 

from 

{select 

Sales_Fact . GRDER_NUMBER as QRDER_NUMEER P 

XSDM { S ale s_Fac t . Qnao 1 1 ty for S ale s__Fac t . Q'RDER_NUMEER > as Qaan 1 1 ty 

from 

{ select 

QRDER_EEADER . ORDERHUMBER as ORDER NDMBER P 
ORDER_DE TAI LS . QUART I T Y as Qaan t i ty 

from 

GO S A LE S . GO S A LE S . go sales. ORDER_HEADER Q‘RDER_BEADER P 
■GO SALES . GO SALES . go sales . ORDER_DE TAILS 0RDER_DE TAI LS 

where 

{ ORDER_HEADER . ORDERHUMBER = ORDER_DE TAI LS . 0RDER_NU1-IEER )■ 

) Sales_Fact 
group by 

SaIes_Fact . 0RDER_NUMBER 

> D2 r 

{select distinct 

XSDM { Re turn s_Fa c t . Re fo.rn_Q.uan t i ty > as Re turn_Quan t i ty 

from 



{ select 

RE TURNED_I TEM . RE TURNQUAHT I T Y as Re tn rnQoan t i ty 

from 

GO SALES . GO SALES . go sales . RE TURNED_I TEI4 RE TDRUED_I TEM f 
■GO S A LE S . GO S A LE S . go sales. 0RDER_E3EADER QRDER_HEADER P 
■GO SALES . GO SALES . go sales . 0RDER_DE TAILS ORDERDETAI LS 

where 



{ORDER_DE TAILS . ORDER_DE'TAI L CODE = RE TURMED_I TEI-1 . QRDER_DE TAI L_CODE } 
{ ORDER HEAE'ER . ORDER_NUMBER = 0RDER_DE TAI LS . ORDER HUHBER) 

} Re turn s_F act 

} D3 



and 



No stitch query is performed and Return Quantity returns only one overall value for 
each record. 
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Workshop 1 : Workshop Results 



SQL for the second test with Order Codes appears as shown below: 



Cog nos SQL 

select 

□ o ale s c e { D 2 . Orde r Numbe r r D3 . Orde r_Numbe r ) as Orde r Numbe r f 
D 2 . Quan tity as Quail t i ty , 

D 3 . Re turn_Qoan 1 1 ty as Re tur o_Quan 1 1 ty 

from 

(select 

Orde r_C odes. Orde r_Nnmb e r as Orde r_Numb e r f 

XSUM (Sale s_Fa c t . Quail tity f o r Orde r_C ode s . Orde r_Numbe r ) as Quan t i ty 

from 

(select 

ORDER_DE TAILS . ORDER_NUMBER as Order_Number ? 

ORDER_DE TAILS. ORDER_DE TAI L_C ODE as Orde r_De t a i 1_C ode 

from 

GOSALES . GO SALES . gosales . ORDERDETAILS ORDER_DE TAILS 
) 0 rde r_C odes f 
(select 

ORDERDE TAI LS . ORDER_DE TAI L CODE as ORDERDE TAI L_C ODE r 
ORDER_DE TAILS . QUANTITY as Quant i ty 

from 

GOS A LE S . GO S A LE S . go s ales . ORDER HEADER OROER HEADER r 
OOSALES . GOSALES . gosales . ORDERDETAILS ORDERDETAILS 

where 

(ORDER HEADER.ORDER NUMBER = ORDER DETAILS . ORDER HUHBER) 

> Sales_Fact 

where 

{ Orde r_C ode s . Orde r_De t a 1 1_C ode = S ale s_F ac t . ORDER_DE TAI L_C ODE ) 
group by 

Orde r_C odes . 0 ! rder_Number 

} D2 

f ul 1 out e r join 
(select 

Orde r_C odes. Orde r_Numbe r as Orde r_Numbe r f 

XSUH-l ( Re turn s_Fac t . Re tur n_Quao tity f o r Orde r_C ode s . Orde r_Nmnbe r ) as Re tur o_Quao t i ty 

from 

(select 

ORDER_DE TAILS . 0RDER_NU1-1BER as 0 rde r_Numb e r f 
ORDER__DE TAI LS . ORDER__DE TAI L_C ODE as Orde r_De t ai I_C ode 

from 

GOSALES . GOSALES . gosales . ORDE R_DE TAI LS ORDER_DE TAILS 

> 0 rde r_C odes f 

i' relent: 



The correct data is returned and the SQL shows a stitch query is performed to merge 
the two fact result sets together. 
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The Consolidation View provides a layer of metadata that is separate from the 
foundation layer that contains all the relationships. To understand query paths, view the 
Foundation Objects View. To view how metadata will be presented to authors, view 
objects in the Consolidation View. 

Consolidating the metadata involves tasks such as consolidating snowflake dimensions 
into one model query subject, or hiding codes found in fact query subjects, which are 
used for relationships. 
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An example of consolidating snowflake dimensions is placing query items from 

PRODU CT_LINE, PRODUCTTYPE, PRODUCT, and 

PPRODU CT_NAME_LOOKUP into a model query subject called Products. 

You can also use the Consolidation View to neady present your facts. For example you 
can create a fact query subject that only contains measures. The codes used in 
relationships found in the underlying Foundation Objects View are simply not added 
and are therefore hidden from authors. 
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In the next demo, you will consolidate product information into one model query 
subject to create a simplified Product dimension that will be presented to users. 

You will also create a simplified model query subject for Sales Fact and the new 
conformed dimension you created in the last workshop called Order Codes. The Order 
Codes dimension is shared between Sales Fact and Returns Fact. 
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Demo 2: Create the Consolidation View 



Purpose: 

To simplify the metadata view for authors, you will consolidate 
related query items into single query subjects. Authors would like 
access to codes but to reduce clutter you will organize them into 
query item folders. 



Components: Framework Manager, Business Insight Advanced 



Project: 

Package: 



GO Operational 
Consolidation View Test 



Task 1. Create a new namespace to contain consolidated 

objects. 

1 . In the Project Viewer pane, in the GO Operational Model namespace, create 
a namespace called Consolidation View. 

2. Drag the new namespace above Foundation Objects View. 

The results appear as follows: 




GO Operational 

GO Operational Model 




^ Consolidation View 



Foundation Objects View 



‘o' gosales 



Sales Fact 

SO ru rr T^nr-i — r 
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Task 2. Consolidate a snowflake dimension. 

1. In the Consolidation View namespace, create a new model query subject 
called Products, and then click OK. 

2. In the Query Subject Definition, expand Foundation Objects 
View>gosales, and then add the following query items to the definition: 



Query Subject 


Query Item 


PRODU CT_LINE 


PRODU CT_LINE_CODE 
PRODU CT_LINE_EN 


Product Type & Product 


PRODU CT_TYPE_CODE 
PRODU CT_TYPE_EN 


PRODU CT_NAME_LOOKUP 


PRODU CT_NAME 
PRODUCT_DESCRIPTION 


Product Type & Product 


PRODU CTJNTUMBER 
PRODU CT_IMAGE 
INTRODU CTION_D ATE 
DISCONTINUED_DATE 
PRODUCTION_COST 
GROSS_MARGIN 



Note: Alternate methods to creating the model query subject include, selecting 
the individual query subjects or the query items within them and then 
merging them into a new model query subject. 



3. Click OK, right-click Products, point to Create, and then click Query Item 
Folder. 

4. Rename the folder to Codes. 
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5. Drag the following items into the folder: 

• PRODU CT_LINE_CODE 

• PRODUCT JTYPE_CODE 

• PRODU CTJNTUMBER 

Authors still need these query items for activities like filtering and drill-through 
scenarios, so moving them into a subfolder is a good way to centralize such 
codes. It also organizes the metadata and makes the main dimensional query 
items easier to locate. 

6. Rename the first three query items in Products as follows: 

• Product Line 

• Product Type 

• Product N ame 

The results appear as follows: 



H Consolidation View 


- ilia p 


roducts 




. 


] Product Line 




1 


| Product Type 




. 


L Product Name 




1 


[ PROD UCT_D ESC R 1 PTIO N 


■ 


. 


[ PRODUCTJMAGE 




Q$ INTRODUCTION DATE 
OS! DISCONTINUED DATE 

OH PRODUCTION COST 

OH GROSS MARGIN 



-l-P^ Codes 



Qg} PROD UCTJJ N E_CO D E 
^ PROD UCT_TYP E_CO 0 E 
D^l PRODUCT_NUMBER 

Normally, you would rename all items, but in order to save time, items will be 
renamed for you in the starting point project at the beginning of the next module. 
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3. Create simplified query subjects for presentation. 

In the Consolidation View namespace, create a new model query subject 
called Sales Fact containing the following query items from Sales Fact in the 
Foundation Objects View: 

• Quantity 

• Unit Cost 

• Unit Price 

• Unit Sale Price 

Create a new model query subject called Returns Fact containing the following 
query item from Returns Fact in the Foundation Objects View: 

• Return Quantity 

Create a new model query subject called Order Codes containing the following 
query items from Order Codes in the Foundation Objects View: 

• Order Number 

• Order Detail Code 

In the Consolidation View namespace, drag Products below Order Codes. 

The results appear as follows: 



±... 5 


£] Consolidation View 




+■ gug Sales Fact 




+■ Returns Fact 




+■ ggg Order Codes 




+ gig Products 



5. Save the project. 

You now have a consolidated view of the data that authors can report from 
without having to know the underlying relationships or table complexity. 
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Task 4. Publish a package of the Consolidation View. 



1 . 

2 . 

3. 



4. 

5. 

6 . 



Right-click Packages, point to Create, and click Package. 

Name the package Consolidation View Test, and then click Next. 

Clear GO Operational Model, expand Consolidation View, and select the 
four model query subjects. 

The results appear as follows: 



□■■■! X 



^ GO Operational Model 



IH */ 



^ Consolidation View 
Sales Fact 




[]|gj Returns Fact 
+ y^p [jjjj Order Codes 
tj- >/pl nM Products 
X 



^ Foundation Objects View 



Click Finish, and then click Yes to open the Publish Package wizard. 
Clear Enable Model Versioning, and then click Next twice. 

Click Publish, and then click Finish. 



You are presented with an information list indicating that the objects you 
published refer to objects not included in the package. In order for the package 
to work, these items will be included in the package but hidden from the users. 

7. Click Close. 



Task 5. Test the Package. 

1 . Launch IBM Cognos Connection, log in, and open Business Insight 

Advanced selecting the Consolidation View Test package for a List report. 

Note that only the selected query subjects appear in the data tree. 
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2. Create a query with the following query items: 



Query Subject 


Query Item 


Order Codes 


Order Number 


Products 


Product Line 


Sales Fact 


Quantity 


Returns Fact 


Return Quantity 



The results appear as follows: 



Order Number 


Product Line 


Quantity 


Return Quantity 


100001 


Camping Equipment 


256 


100001 


Personal Accessories 


92 




100002 


Outdoor Protection 


422 




100002 


Personal Accessories 


493 




100003 


Outdoor Protection 


4,359 




100003 


Personal Accessories 


107 


19 


100004 


Camping Equipment 


1,033 




100005 


Golf Equipment 


26 




100005 


Personal Accessories 


635 




-iririnng 




2_ZZJ 



You have successfully created a report from a simplified and author- friendly 
model that hides the underlying complexity of the metadata. 

3. Close the browser without saving the query. 

Results: 

You have created consolidated and simplified query subjects to 
meet reporting needs, and you have tested the resulting package in 
Query Studio. 
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During the modeling process, you discovered another important dimension that can be 
used to report against Sales Target. In the next workshop, you will create a consolidated 
model query subject to allow users to report on sales targets by location. 

You will also create a simplified view of Sales Target. 
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Business Analytics 



Requirements Review (cont'd) 

■ ^ M Recommendation #1 




Cognos 

software 



©2010 IBM Corporation 



During the modeling process, you also discovered an alternate and important 
dimension that can be used to report against Sales Fact. In the next workshop, you will 
create a consolidated model query subject called Branch by Location. 
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Workshop 2: Consolidate and Simplify the Model for 

Presentation 



You will continue to consolidate related query items into single query subjects to 
simplify the presentation of metadata for authors. 

Create consolidated and simplified query subjects in the Consolidation View to meet 
these needs, as follows: 

• Create a consolidated Sales Target by Location dimension from 
SALES_REGION and COUNTRY as shown in the Workshop Results section 
that follows the Task Table. 

• Create a consolidated Branch by Location dimension from Branch Region (alias), 
Branch Country (alias), and BRANCH as shown in the Workshop Results 
section that follows the Task Table. 

• Create a simplified Sales Target Fact containing just gosales.S ALE S_T ARGFT> 
S ATE S T ARGET and renamed to mixed case. 

For more detailed information outlined as tasks, see the Task Table on the next page. 

To see the desired queries and model query subject contents, see the Workshop Results 
section that follows the Task Table. 

Save the project when you are finished. 
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Workshop 2: Task Table 



Task 


Where to Work 


Hints 


1 . Create the 

consolidated Sales 
Target by Location 
dimension 


Project Viewer, 
Query Subject 
Definition dialog 
box. 


• SALES_REGION : 
SALES_REGION_CODE 
SAT ES_R EGT ON_EN 

• COUNTRY: 

COUNTRY _CODE 
COUNTRY _EN 

• Rename query items to Sales 
Target Region Code, Sales Target 
Region, Sales Target Country 
Code, and Sales Target Country 

• Place Sales Target Region Code 
and Sales Target Country Code in a 
new Codes query item folder 
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Task 


Where to Work 


Hints 


2. Create the 
consolidated 
Branch by Location 
dimension 


Project Viewer, 
Query Subject 
Definition dialog 
box. 


• Branch Region (alias) : 

Branch Region Code 
Branch Region 

• Branch Country (alias): 

Branch Country Code 
Branch Country 

• BRANCH: 

BRANCH_CODE 
ADDRESS 1 
ADDRESS2 
CITY 

PROV_STATE 

POSTAL_ZONE 

• Place the three codes in a new 
Codes query item folder. 

• Rename all query items from 
BRANCH to mixed case with a 
'Branch' prefix (for example, 
Branch Address 1) 

• Organize dimensions alphabetically 
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3. Create a simplified 


Project Viewer, 


• SALES_TARGET > 


Sales Target Fact. 


Query Subject 
Definition dialog 


SALES_TARGET 




box. 


• Rename query item to Sales Target 






• Drag Sales Target Fact to just 






below Returns Fact 






• Save and close the project 



8-34 © 2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 

or translated into another language without a legal license agreement from IBM Corporation. 









MODELING FOR PREDICTABLE RESULTS: CONSOLIDATE METADATA 



Workshop 2: Workshop Results 



Your Consolidation View should appear as shown below: 



U Consolidation View 
Hg Sales Fact 
Hg Returns Fact 
llg Sales Target Fact 
Sales Target 




- BHH & 


ranch by Location 




1 


J_ Branch Region 




. 


| Branch Country 




. 


J_ Branch .Address 1 




. 


J_ Branch Address 2 




1 


L Branch City 




. 


[ Branch F'rov/State 




[JI] Branch Postal Zone 






|- ^3 Codes 

Branch Region Code 
Branch Country Code 
Branch Code 
ggg Order Codes 
Products 

ggg Sales Target by Location 
] Sales Target Region 
Sales Target Country 
I- £3 Codes 

Sales Target Region Code 
Sales Target Country Code 
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Business Analytics 

Summary 

■ You should now be able to: 

■ create virtual facts to simplify writing queries 

■ create virtual dimensions to resolve fact-to-fact 
joins 

■ create a consolidated modeling layer for 
presentation purposes 

■ consolidate snowflake dimensions with model 
query subjects 

■ simplify facts by hiding unnecessary codes 

Cognos® 

software 

©2010 IBM Corporation 
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Business Analytics ^==^~ 

Objectives 

■ At the end of this module, you should be able to: 

■ use calculations to create commonly-needed query 
items for authors 

■ use static filters to reduce the data returned 

■ use macros and parameters in calculations and 
filters to dynamically control the data returned 



Cognos* 

software 

© 201 0 IBM Corporation 
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Business Analytics 



Framework Manager Workflow 



Framework Manager 



Create 

Project 




Import 

Metadata 



Prepare 

Metadata 



Publish 



Set 

Security 



Model 

Metadata for 
Reporting 



I 



Create and 
Manage 
Packages 



Data 

Sources 



Content 

Store 



Report Studio 
Query Studio 
Analysis Studio 



Cognos. 

software 

) 201 0 IBM Corporation 



This module deals with creating calculations and filters to add business logic to the 
model. 
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Business Analytics 



Create Calculations 



Recommendation #6 



■ Create calculations to provide report authors 
with values that they regularly use. 

■ Revenue = Quantity * Unit Sale Price 

■ Calculations can use query items, parameters, and 
functions. 

■ Two types of calculations: 

■ embedded 

■ stand-alone 



Cognos* 

software 

© 201 0 IBM Corporation 



If you want to create a calculation specifically for one query subject or dimension, you 
can embed the calculation direcfiy in that object. For query subjects, this calculation can 
be done for either data source query subjects or model query subjects. However, it is 
recommended that you apply calculations in model query subjects wherever possible. 
This allows for better maintenance and change management. 

Create a stand-alone calculation when you want to apply the calculation to more than 
one query subject or dimension. Stand-alone calculations are also valuable if you need 
to do aggregation before performing the calculation (as shown in Appendix A) . 
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Purpose: 

Report authors want to include the revenue, gross profit, and 
margin of each order in their reports. Therefore, you will create three 
embedded calculations in the Sales Fact query subject. This will 
produce three new query items. 

Component: Framework Manager 

Project: GO Operational 

Task 1 . Create the calculations. 

1. In Framework Manager, close any projects that may be open, and then open 

the GO Operational model located at C:\Edcognos\B5152\CBIFM-Start 
Files\Module 9\GO Operational. 

2. Expand Foundation Objects View>gosales, and then double-click Sales 
Fact. 

The calculations you are about to create could also be placed in the 
Consolidation View Sales Fact model query subject. However, placing them in 
the lower level increases opportunities for reusability. 

3. Click Add in the bottom right corner. 

4. In the Name box, type Revenue, and then, in the Available Components 
pane, double-click Quantity. 

5. Click the Functions tab, expand Operators, and then double-click the 
multiplication operator (*) . 

Notice there is a description of the function in the Tips pane. 
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7 . 

8 . 




Under Available Components, click the Model tab, and then double-click 

Unit Sale Price. 

The results appear as follows: 

[gosales]. [Sales Fact]. [Quantity] * [gosales]. [Sales Fact]. [Unit Sale Price] 




Click Test Sample I to verify that the calculation works, click OK. 

Create a Gross Profit calculation with the following expression: 

[gosales] . [Sales Fact]. [Revenue] - ([gosales]. [Sales Fact]. [Quantity] * 
[gosales] . [Sales Fact]. [Unit Cost]) 

Where Revenue is the calculation you just created. 

Create a Margin calculation with the following expression: 

[gosales] . [Sales Fact]. [Gross Profit] /[ gosales] . [Sales Fact]. [Revenue] 

Where Gross Profit and Revenue are the calculations you just created. 

Currently the new calculations appear as attributes because they have not been 
evaluated yet. 
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10. Click OK 



The query subject and its new calculations are evaluated. 
The results appear as follows: 



IIqi Sales Fact 

DIP ORDER_N UMBER 
j R ETAI LER_S IT E_CO D E 
RETAILER_CONTACT_CODE 
SALES STAFF CODE 






ID 



SALES_BRANCH_CODE 



Qg} ORDER_DATE 
Qg} ORDER_CLOSE_DATE 
QE) ORDER_METHOD_CODE 
0g} ORDER_DETAIL_CODE 
Qgl SHIP_DATE 
Dgl PRODUCT_NUMEER 
[| P RO MOTIO N_CO D E 
Quant it?/ 

Unit Cost 
Unit Price 
Unit Sale Price 
Revenue 
Gross Profit 
Margin 










The calculations now appear as facts. 
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Task 2. Set formatting properties on query items in the 

Foundation Objects View. 

1. Under Sales Fact, select Revenue and Gross Profit. 

2. If necessary, from the View menu, click Properties. 

3. In the Properties pane, for the Revenue query item, set the Format type to 
Currency, and the Currency property to $ (USD) - United States of 
America, dollar. 

4. Apply the same formatting to the Gross Profit query item by dragging down 
the small black arrow. 

5. Format Margin as a percentage. 



Task 3. Update the Consolidation View Sales Fact query 

subject and test. 



1 . 

2 . 

3. 

4. 



In the Consolidation View, double-click Sales Fact. 

Add the three new calculations from Foundation Objects View > gosales > 
Sales Fact. 




Click Revenue and then click Top l=£J to move 



Click the T est tab, and then click T est Sample. 
Notice that Margin = Gross Profit / Revenue, as 



it to the top of the list, 
expected. 
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5. Click OK 



The results appear as follows in the Project Viewer: 



HI 



Consolidation View 
Sales Fact 
Hlffl Revenue 

| Dt Quantity 

Unit Cost 
51 Unit Price 
51 Unit Sale Price 
51 Gross Profit 
; H Margin 



6. Save the project. 

Results: 

You created and tested three embedded calculations within the 
Sales Fact query subject. This produced three new query items that 
report authors can exploit. 
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Business Analytics 



Filter Data 

■ Two types of filters 

■ embedded 

■ stand-alone 



Recommendation #6 



:ry Subject Definition Filters Determinants Test Query Information | 



•ailable Model Filters: 



gosales_goretailers 
- ^ Filters 



+ 



V Americas 
y Asia Pacific 
y Europe 

Central Europe 
y Northern Europe 
y Southern Europe 



u ataoase view 



Filters: 



N ame 


Usage 


S ource 


1 gosales_goretailers. Filters. Americas Always 


| Countries. Sales territory code = 1 j 


^j»- Retailer 

i 


Always 


Orders. Retailer name = 'Falcon Outfitters' 


i Embedded filter 






Stand-alone filters 





Cognos* 

software 
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Again, embedded filters are appropriate when the filter is intended for just one query 
subject or dimension. Stand-alone filters are appropriate when required in multiple 
query subjects or dimensions or to make commonly used filters readily available for 
authors. 

Filters have a Usage setting with the following options: 

• Always - the filter will be applied in all instances regardless of whether the filtered 
query item is in the query or not 

• Optional - the filter is not mandatory and users may choose to enter a filter value 
or leave it blank (only applies to filters that use a prompt value or macro) 

• Design Mode Only - Limits the amount of data that is retrieved when testing in 
Framework Manager or at report design time (when authoring reports in Query 
Studio and Report Studio) 
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Demo 2: Create Embedded and Standalone Filters 



Purpose: 

Employee data includes historical job information that is beyond the 
scope of the reporting application you are building. So you will 
restrict EMPLOYEE_HISTORY to each employee's current record. 

Report authors also want the ability to easily restrict retailer data to 
specific regions. To do this, you will create standalone filters that 
authors can apply during report creation. 



Components: Framework Manager, Business Insight Advanced 

Project: GO Operational 

Package: GO Operational 

Task 1 . Create an embedded filter to retrieve current 

employee records. 

To restrict retrieval to an employee's current record, you can filter on 
EMPLOYEE_HISTORY.RECORD_END_DATE IS NULL. This signifies 
that the employee has not yet ended their current position. 

You will place the filter on EMPLOYEE_HISTORY in the Foundation 
Objects View rather than on Staff by Location in the Consolidation View. This 
is because the filter causes the relationship between EMPLOYEE and 
EMPLOYEE_HISTORY to change from one-to-many to one-to-one, and all 
our relationships are in the Foundation Objects View. Changing this cardinality 
also prevents EMPLOYEE_HISTORY from acting as an ambiguous query 
subject. 

1. In the Project Viewer pane, expand Foundation Objects View>gosales, and 
then double-click EMPLOYEE HISTORY. 
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2. Click the Filters tab, click Add, and then in the Name box, type Current 
Employee History Record. 

3. In the Available Components pane, double-click RECORD_END_DATE. 

4. Click in the Expression Definition pane at the end of the expression, and then 
type IS NULL. 

The results appear as follows: 

[gosales] . [EMPLOYEE_HISTORY] . [RECORD_END_DATE] IS NULL 

5. Click OK, click the Test tab, and then click Test Sample. 



The results appear as follows: 



Test results 


TQRY_PARENT 


ENPLOYEECODE 


R ECO R D_START_D ATE 


R ECO R D_EN D_D AT E 


P0SIIT10N_C0I 






10004 


Dec 11.2001 12:00:00 AM 




4500 






1 'DC-35 


Nov 24, 2003 12:00:00 AM 




5700 






10006 


May 10,2006 12:00:00 AM 




5500 






10007 


Oct 3, 2003 12:00:00 AM 




5600 






10012 


Mar 22, 2005 12:00:00 AM 




5400 






10013 


Nov 7, 200D 12:03:00 AM 




5000 






10014 


May 12, 2003 12:00:00 AM 




5700 






10015 


.Apr 18, 2037 1 2:00:00 AM 




5000 






10016 


Dec 20, 2034 12:00:00 AM 




5700 






~l fU~l~l ~7 n TJl TfUU ~l T--fU~L-fU~L A M 




a nn 



Just one record for every employee is returned and each has a null 

RECORD_END_DATE. 

6. Click OK 

7. Right-click EMPLOYEE_HISTORY and click Launch Context Explorer. 

8. Click Show Related Objects, and then double-click the relationship between 

EMPLOYEE_HISTORY and EMPLOYEE. 

9. Change the EMPLOYEEJHISTORY side to 1..1, reflecting the impact of the 
new filter. 

10. Click OK, close the Context Explorer, and then save the project. 
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Task 2. Create Standalone Retailer Location Filters. 

1 . In Foundation Objects View>gosales, right-click SALES_REGION, click 
Test and then click Test Sample. 

The five regions are as follows: 

710 = Americas 
740 = Asia Pacific 
750 = Northern Europe 
760 = Central Europe 
770 = Southern Europe 

2. Click Close, and then, in the Consolidation View, create a new folder called 

Model Filters. 

3. In the new Model Filters folder, create a new folder called Retailer Location 
Filters. 

4. Right-click Retailer Location Filters, point to Create, and then click Filter. 

5. In the Name box, type Americas. 

6. In the Available Components pane, under Consolidation View, expand 
Retailer by Location>Codes. 

7. Add Retailer Site Region Code to the Expression definition pane, and then 
type = 710 . 

The results appear as follows: 

[Consolidation View] . [Retailer by Location] .Retailer Site Region Code] = 710 

8. Click OK 
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9. Repeat steps 4 to 8 to create new filters using the appropriate Retailer Site 



Region Code. 



Retailer Site 


Retailer Site Region Code 


Asia Pacific 


740 


Northern Europe 


750 


Central Europe 


760 


Southern Europe 


770 



Tip: You can also copy the Americas filter and simply edit it to meet your 
needs. 

The expression for Asia Pacific will appear as follows: 

[Consolidation View] . [Retailer by Location] .Retailer Site Region Code] = 740 

The results appear as follows: 

i-B Model Filters 

□~ C7l Retailer Location Filters 
I y Americas 

| Y Asia Pacific 

I ^ Northern Europe 

I T Central Europe 

j Y Southern Europe 

10. Save the project. 

Task 3. Test the Standalone Filters. 

1 . Publish the GO Operational package. 

2. If necessary, open IBM Cognos Connection, log on, open Business Insight 
Advanced, and then select the GO Operational package for a List report. 
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3. In the Insertable Objects pane, expand Consolidation View> Retailer by 
Location. 

4. Add Retailer Site Country to the report. 

5. Expand Model Filters > Retailer Location Filters, and then drag Americas 
onto the report. 

The results appear as follows: 

Retailer Site Country 

Brazil 

Canada 

:■ < 

Mexico 

United States 

The report is limited to records for the American continents. 

6. Close your browser without saving the report, and leave Framework Manager 
open for the next demo. 

Results: 

You embedded a filter into EMPLOYEE_HISTORY to restrict the data 
to each employee's current record. You also created stand-alone 
filters for retailer locations that authors can apply during report 
creation. 
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Business Analytics 

Customize Metadata for Run Time 

Recommendation #6 

■ Modify query subjects to dynamically control the 
data returned using: 

■ session parameters 

■ parameter maps 

■ macros 



Cognos* 

software 
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This concept can be used to dynamically return data from specific columns or rows, 
and even from specific data sources. 

One example is to dynamically implement security by using a calculation to retrieve a 
user's account, group, or role information and then implement row-level security based 
on values stored in the data source. 

Another example might be to retrieve location specific data for a particular user. For 
example, if a user works in Mexico, you can use a calculation to return sales values for 
Mexico by querying the Revenue_Mexico column rather than other columns in the 
table such as Revenue_Canada or Revenue_Germany. 
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Business Analytics 

IBM Cognos Environment Session Parameters 

■ Predefined and stored in the content store database 





Parameter 


Value 


Override Value 


m 


account, def aultN ame 


Bart Scott 




m 


account, parameters. Location 


Seattle 




m 


account, personall nf o. businessPhone 


1 (206) 292-001 2 




m 


account, personall nf o. email 


BScott@grtd123.com 




m 


account, personall nf o. faxPhone 


1 (206) 292-331 2 




m 


account, personall nf o. givenN ame 


Bart 




m 


account, personall nf o. surname 


Scott 




m 


account, personall nf o. userN ame 


scottb 




m 


runLocale 








Cognos. 

software 
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A session parameter returns session information at run time (for example, runLocale or 
account.U serName) . 
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Business Analytics 

Parameter Maps 

■ Used to substitute one value for another 

■ Keys must be unique 




Key 


Value 


Bart Scott 


60 


Ana Orozco 


80 


Alex Rodriguez 


53 




Source Values 



Target Values 
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software 
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A parameter map is a two-column table, mapping a set of keys (source) to a set of 
substitution values (target). 

The above example uses a parameter map to convert the account.DefaultName session 
parameter to a suitable value in the data, in this case a staff key value. 
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Business Analytics 



Macros 



Filter Expression 



tSalesTarget-FactMSaJes.Staff.-CodeT- 

^$Securit^Lookup- ' Saccount .d efaultName|} -# 



\ - 

y 

Parameter Map 




Macro 



Session Parameter 
passed to parameter map 




Cognos. 

software 
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A macro is a fragment of code that you can insert within filters, calculations, properties, 
and so on, that are to be evaluated at mn time. Macros are enclosed by the # character. 

You will use the technique illustrated in the slide later in the course when applying 
security. 
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Business Analytics 



Dynamically Retrieve Language Column 

Recommendation #6 



a (BO SALESJ1EGION 

y SALE S^REGlQN^CCOE Region calculation = 

H sales"region[en * sales_region_' + 

| SALE S_RE 6(0 N_FR a string based on 

B salesIregionIqe 



if user's locale setting 



1. Call runLocale session parameter: en, en-uk, fr, ... 

2. Use a parameter map to convert to EN, FR, ... 

3. Concatenate the results with a string to form the desired 
column name 



- SALES_REGION_EN 

■ SALES_REGION_FR 

■ and so on 



Cognos* 

software 
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In the next demo, you will dynamically return a specific column in the data source 
based on a user's locale. 
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Demo 3: Calculate Based on Local Language 



Purpose: 

Authors at The Great Outdoors Company would like report 
consumers to automatically view region names in the language of 
their locale. To do this, you will replace Retailer Site Region with a 
calculation that references a parameter map and a session 
parameter. You will then make this calculation standalone, so that 
you can reuse it for Branch Region, Staff Region, and Sales Target 
by Location. 



Component: Framework Manager 

Project: GO Operational 

Task 1 . Create a parameter map. 

1. In the Project Viewer pane, Foundation Objects View>gosales, expand 
SALES_REGION. 

This query subject has column-based multilingual data. You pick the 
appropriate language column for the language you wish to view the data in. 

2. Double-click Retailer Site Region (alias). 

This model query subject was created with just one language query item, 
SALES_REGION_EN. You want to change this to pick the underlying query 
item based on a user's locale session parameter at mn time. For example, the 
session locales for United States and France are en-us and fr-fr. 

3. Click Cancel. 

You will now create a parameter map to substitute a locale session parameter to 
a value found in the data. 
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4. Right-click Parameter Maps, point to Create, and then click Parameter Map. 

The Create Parameter Map wizard opens. You can type in the values if you only 
support a small set of languages, or import the values from a file. You can also 
base the parameter map on query items within the model. For example, you 
may have a table in the database that is used to map language locales to 
language values matched by the data in other tables. If this is the case and the 
table is quite large, consider placing a filter on the query subject based on the 
session parameter you are using to look up the value (in this case runLocale). 
This reduces the record set down to one record rather than forcing a scan of 
the entire table at mn time. For example, if the value is en-us at mn time, then 
the query subject will only return one row consisting of en-us and EN (the key 
field and the value field) instead of all rows. In other words, you are dynamically 
reducing the parameter map list to one record before accessing it for a value. 

For this exercise there is no table that contains these mapping values, so you 
will use a text file that has the mappings entered for you. 

5. In the Name box, type Language_lookup, and then click Next. 

6. Click Import File. 

7. Next to the Filename box, click Browse. 

8. Navigate to <IBM Cognos install drive> Program Files\IBM\cognos\ 
clO\webcontent\ samples\models, click Language_lookup.txt, and then 
click Open. 

9. Click OK 

The values in the file are imported. Note that 'en-us' (and all other English 
variants) map to 'EN'. The same applies for other languages and their locales. 

10. Click Finish. 
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Task 2. Create an embedded calculation for multilingual data. 



1. In Foundation Objects View>gosales>Retailer Site Region (alias), 
double-click Retailer Site Region. 

2. In the Expression definition pane, to the left of 

[gosales] . [ SALES_REGION] . [SALES_REGION_EN] , type #’ 

3. Replace EN] with ’ + 

The results appear as follows: 

#' [gosales] . [SALES_REGION] . [SALES_REGION_’ + 

4. Under Available Components, click the Parameters tab, expand Parameter 
Maps, and then double-click Language_lookup. 

5. Collapse Language_lookup, expand Session Parameters, and then double- 
click runLocale. 




7. 



8 . 



At the end of the expression, type + ’]’# 

Delete any extra # symbols so the results appear as follows: 

#' [gosales] . [SALES_REGION] . [SALES_REGION_' + 

$Language_lookup { SmnLocale } + ']'# 

The # character at the beginning and the end of the expression identify this 
expression as a macro. 



Note: This technique hard codes the path to your source query item. If you 
move or rename the source, you will have to update this calculation 
manually. 




Click T est Sample j_ I to 
locale, and then click OK. 



verify that the calculation works for your current 



The Sales Region data will all display in the appropriate language. 
Save the project. 
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Task 3. Test the calculation under a different language. 

1. From the Project menu, point to Languages, and then click Define 

2. Scroll down to French, double-click French to add it to the list of Project 
languages, and then click OK twice. 

3. If necessary, from the View menu, click Tools. 

4. In the Tools window, if necessary, click the Summary tab, and then change 

Active Language to French. 

Notice that all object names in the Project Viewer are preceded by "(fr)". This is 
to remind you to translate the strings if required. 

5. Right-click (fr) Retailer Site Region (alias), click Test, and then click Test 
Sample. 

The results appear as follows: 



Test results 




tfr) Retailer Site Region Code 


■Jr} Retailer Site Region 




71 a 


Ameriques 




74 a 


Asie-Pacifique 




75a 


Europe septentrionale 




7 sa 


Europe centrale 




77a 


Europe meridionale 



The names appear in French based on the macro you created. 

6. Click Close, and then change the Active Language back to English. 
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Task 4. Make the calculation reusable. 



1. In Foundation Objects View>gosales, double-click Retailer Site Region 
(alias). 

2. Right-click Retailer Site Region, and then click Convert to Stand-alone 
Calculation. 

3. Click OK, and then, double-click the new Retailer Site Region calculation at 
the bottom of the gosales namespace. 

The calculation has been preserved. 

4. Click Cancel. 

5. In the gosales namespace, create a folder called Reusable Objects, and then 
create a folder called Model Calculations in the Reusable Objects folder. 

6. Drag the Retailer Site Region calculation into the Model Calculations 

folder. 



7. Rename the calculation to Region. 
The results appear as follows: 

T | | IIUII I d I jdIHi-J ji HULUN IS '■-■ l L , |UULS 

q-Ea Reusable Objects 

Model Calculations 
^ Region 
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Task 5. Apply the calculation to Branch Region (alias). 

1. Expand Branch Region (alias), and then double-click Branch Region. 

The expression uses the English region column. Rather than recreate the more 
generic language-based version, you will reuse the Region calculation. 

2. Delete the expression in the Expression definition box. 

3. In the Available Components pane, expand Reusable Objects>Model 
Calculations, and then double-click Region. 

4. Test the expression, and then click OK 

5. Repeat steps 1 to 3 to apply the Region calculation to the Staff Region (abas) 
query subject, and the Sales Target by Location query subject located in the 

Consobdation View. 

To see if you applied the calculation in all the required locations, you can use 
the Show Object Dependencies feature. 
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6. Right-click the Region calculation, and then click Show Object 
Dependencies. 



In the Tools pane, a list of dependant objects is displayed. 



Dependent objects 



- 



m 



m 





m 



m 



GO Operational 
Branch Region 
GO Operational 
] Branch Region 
Retailer Site Region 
GO Operational 
[[] Retailer Site Region 
Staff Region 

GO Operational 
Staff Region 
Sales Target Region 
GO Operational 




You can click any of these objects to give them focus in the Project Viewer or 
Diagram pane. By doing this, you can verify you applied the calculation in all 
required areas. 



Results: 

You modified Retailer Site Region (alias) to automatically view 
region names in a language based on the report consumer's locale. 
You then made the calculation stand-alone, and reused it for the 
Branch Region (alias). 
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Business Analytics 



Filter Based on Locale 



Product Number/' 


\ 

Product Language 


Product Name 


99110 


DE 


Aloe Balsam 


99110 


DA 


Aloe Lindring 


99110 


NO 


Aloe lotion 


99110 


EN 


Aloe Relief 



N PRODUCT LANGUAGE Filter = 



Recommendation #6 



a string based on user's locale setting 



1. Call runLocale session parameter: en, en-uk, de, ... 

2. Use a parameter map to convert to EN, DE, ... 

3. Use sq macro function to wrap in single quotes: 'EN', 




software 
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The same process that you used to create a calculation when the language selection is 
column-based can be used to create a filter when the language selection is row-based. 
Instead of building up a string for the column name, you simply create the st rin g 
matching a PRODUCT_LANGUAGE row value and filter on this value. 
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Workshop 1: Filter Local Language 



Each product has multiple records in the PRODUCT_NAME_LOOKUP table, one 
per language. Authors at the Great Outdoors Company want report consumers to 
automatically view product names in the language of their locale. To do this, add a filter 
to PRODU CT_N AME_LOOKUP which equates PRODU CT_LAN GUAGE to 

#sq( $Language_lookup {$runLocale} ) # 

To do this: 

• Use the runLocale session parameter to extract the locale. 

• Convert the locale to the format of our PRODUCT_LANGUAGE column by 
using the Language_lookup parameter map that you created earlier. 

• Wrap the string in single quotes by using a macro called sq. 

Note that the filter changes the nature of the relationship between 
PRODU CT_NAME_LOOKUP and Product Type & Product to be 1..1 on both 
sides. Applying this filter and changing the cardinality will resolve unexpected results 
when querying Product Name. 

Test your underlying changes in the Consolidation View using Product> Product Name 
and Sales Fact>Revenue. 

For more detailed information outlined as tasks, see the Task Table on the next page. 

To see the desired filters, see the Workshop Results section that follows the Task 
Table. 

Save the project when finished. 



9-30 © 2003, 2010, IBM Corporation 

This guide contains proprietary information which is protected by copyright. No part of this document may be photocopied, reproduced, 

or translated into another language without a legal license agreement from IBM Corporation. 






CALCULATIONS AND FILTERS 



Workshop 1: Task Table 



Task 


Where to Work 


Hints 


1 . Add a filter to 
PRODUCT_ 
NAME_LOOKUP 


Project Viewer, 
Foundation View, 
gosales 


• Double-click the query subject. 

• Click the Filters tab. 

• Click Add. 

• Name it 'Language Filter'. 


2. Create the filter 
definition. 


Available 

Components, 

Expression 

definition 


• Add PRODUCT_LANGUAGE 

to the expression. 

• Type = at the end of the 
expression. 

• From Available Components, on 
the Parameters tab, expand Macro 
Functions and double-click sq. 

• Expand Parameter Maps and 
double-click Language_lookup. 

• Expand Session Parameters and 
double-click runLocale. 

• Click OK then test the filter using 
the Test tab. All product names 
should be in your current language. 
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Task 


Where to Work 


Hints 


3. Update 
relationship. 


Project Viewer, 
Context Explorer 


• Change the relationship between 

PRODU CT_N AME_LOOKUP 
and Product Type & Product to be 
1..1 on both sides. 

• Test in the Consolidation View 
using Products>Product Name 
and Sales Fact>Revenue 

• Save the project. 
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Workshop 1 : Workshop Results 



Your Local Language filter in PRODUCT_NAME_LOOKUP should appear as 
follows: 



[gosales] . [PRODU CT_NAME_LOOKUP] . |PRODUCT_LAN GU AGE] = 
# sq($Language_lookup { $runLocale } ) # 



Your test on Product Name and Revenue should appear as follows: 







Product Name 


Revenue 






'Ricker Lantern 


■S i S24.fi4 






Polar Ice 


941 1 .€ 






Edge Extreme 


1 8332 .22 






Bear Edge 


€€9C.9 






Glacier GPS Extreme 


24747.32 






Mountain Man Deluxe 


€925 .€ 






Insect Bite Relief 


2532 






BugShield Extreme 


21170.52 






Sun Shield 


€37€.32 






Seeker 5G 


1 0975.36 






Polar Extreme 


2733.15 






Hibemator Lite 


29€59.12 






Star Lie 


99941.42 






Star Gazer 2 


75299.35 



Product names are now only returned in one language. 
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Workshop 2: Calculate Based on Local Language 



Recall that to meet business needs, you created a reusable Region calculation for both 
Retailer Site Region and Branch Region as well as the Sales Target by Location query 
subject in the Consolidation View. You will now do the same thing for Retailer Site 
Country, Branch Country, and Sales Target by Location with a Country calculation. 

Create a calculation as follows: 



• Create a new calculation in Reusable Objects >Model Calculations, called 
Country. 



Set its expression to 

#' [gosales] . [COUNTRY] . [COUNTRY.' + $LanguageJookup{$runLocale} + ']’# 



• Change the definitions of Branch Country (alias) > Branch Country, Retailer Site 
Country (alias) > Retailer Site Country, Staff Country (alias), and Sales Target by 
Location in the Consolidation View to point to this calculation. 



For more detailed information outlined as tasks, see the Task Table on the next page. 
Save the project when finished. 
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Workshop 2: Task Table 



Task 


Where to Work 


Hints 


1 . Create a Country 
calculation. 


Project Viewer, 
Foundation View, 
gosales, Reusable 
Objects, Model 
Calculations 


• Right-click the Model Calculations 
folder, Create > Calculation. 

• Name the calculation Country. 


2. Create the 
expression. 


Available 

Components, 

Expression 

definition 


• Set its expression to 
#' [gosales] . [COUNTRY] . 
[COUNTRY.' + 

$Language_lookup{$runLocale} + 

T# 


3. Change the four 
query subjects to 
use the calculation. 


Project Viewer, 
Query Subject 
Definition dialog 
boxes for Retailer 
Site Country (alias) 
and Branch Country 
(alias) 


• In the Branch Country (alias) query 
subject, edit Branch Country. 

• Delete the Expression definition. 

• In Available Components, locate 
the new calculation and add it to 
the Expression definition. 

• Test, and then click OK. 

• Repeat for Retailer Site Country 
(alias), Staff Country (alias), as well 
as Sales Target by Location in the 
Consolidation View. 

• Save and close the project. 
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Workshop 2: Workshop Results 



Your Country calculation expression should appear as shown below: 



#' [go sales] . [COUNTRY] . [COUNTRY.’ + $Language_lookup { SrunLocale } + ’]’# 



This new calculation should be referenced in the following: 



Your Branch Country (alias) model query subject 



Query Hems and Calculations: 


1 Name 


Source 


1 Branch Country Code 


CO U NTR Y.CO UiNTR Y_CO DE 


|]jjl Branch Region Code 


CO U NTR Y.5 ALES_R EG 10 N_C0 D E 


| Branch Country ^ 


Country 



Your Retailer Site Country (alias) model query subject 



Query Items and Calculations: 


Name 


Source 


||^J Retailer Site Country Code 




CO UN TRY. 00 UNTRYCODE 


PjJi Retailer Site Region Code 




CO U NTR Y.S ALES_R EG 10 N_C0 D E 


Ml Retailer Site Country 


Country 





Your Staff Country (alias) model query subject 



Query Items and Calculations: 


| Name 


Source 


1 1| ! ! Staff Country Code 




CO U NTR Y.CO UNTR Y_CO DE 


Y Staff Region Code 




CO U NTR Y.S ALES_R EG 10 N_CO D E 


[] Staff Country 


Country 





Your Sales Target by Location model query subject 



Query Items and Calculations: 


Name 


Source 


| | Sales Target Region 


Region 1 


[ Sales Target Country | 


Country 


fe* Sales Target Region Code 


SALES_R EG 10 N ,SALES_R EG 10 N_C0 D E 


mjl Sales Target Country Code 


CO U NTR Y.CO U NTR Y_C0 D E 
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CALCULATIONS AND FILTERS 



Business Analytics ^==^~ 

Summary 

■ You should now be able to: 

■ use calculations to create commonly-needed query 
items for authors 

■ use static filters to reduce the data returned 

■ use macros and parameters in calculations and 
filters to dynamically control the data returned 



Cognos* 

software 

© 201 0 IBM Corporation 
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Business Analytics iEhE^z 

Objectives 

■ At the end of this module, you should be able to: 

■ make time-based queries simple to author by 
implementing a time dimension 

■ resolve confusion caused by multiple relationships 
between a time dimension and another table 



Coanos* 

software 

©2010 IBM Corporation 
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Business Analytics 



Framework Manager Workflow 



Framework Manager 



Create 

Project 




Import 

Metadata 



Prepare 

Metadata 



Publish 



Set 

Security 



Model 

Metadata for 
Reporting 



I 



Create and 
Manage 
Packages 



Data 

Sources 



Content 

Store 



Report Studio 
Query Studio 
Analysis Studio 



Cognos* 

software 



©2010 IBM Corporation 



This module teaches the technique of implementing a time dimension in an operational 
model to simplify time-based queries across different facts. 
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Business Analytics 



Report without a Time Dimension 



Reports require date calculations to match fields 



Product 




Sales Target Fact 


1..1 














SALES YEAR 1 






1..n 


ISALES PERIOD 1 


1..n 






k SALES_TARGET 



Sales Fact 



ORDER DAT I 



QUANTITY 



No common date fields 



Cognos. 

software 

©2010 IBM Corporation 



Either modelers or report authors must create calculations that manipulate date data to 
create matching values that can be used to compare data from different areas of the 
business. This can cause slower performance because you are now comparing data on 
non-indexed values. 

In the slide example, you would need to create two calculations on ORDER_DATE in 
the Sales Fact query subject to match the SALES_YEAR and SALES_PERIOD fields 
in the Sales Target Fact query subject. You will see this in the next demo. 

Other issues when using date fields from fact tables include the inability to properly 
stitch these queries together since there is no conformed dimension used. 
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Demo 1 : Report without a Time Dimension 



Purpose: 

A typical business report compares the monthly sales targets to 
actual sales. You will see if this is easily accomplished with your 
current data. 



Components: Framework Manager, Business Insight Advanced 

Project: GO Operational 

Package: GO Operational 

Task 1 . Examine problems when a time dimension is absent. 

1. In Framework Manager, close any projects that may be open, and then open 

the GO Operational project located at C:\Edcognos\B5152\CBIFM-Start 
Files\Module 10\GO Operational. 

2. If prompted, log in as User ID admin, and Password Education!.!. 

3. Publish the GO Operational package, launch IBM Cognos Connection, log 
on, and then open Business Insight Advanced selecting the GO Operational 

package for a List report. 
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4. Add the following items to the report from Foundation Objects View: 



Query Subject 


Query Item 


Sales Fact 


ORDER_DATE 

Revenue 


SAT ES_T A R GET 


SALE S_ YEAR 
SALESJPERIOD 
SAFEST ARGET 



The results appear as follows: 





ORDER_DATE 


Revenue 


SALES. YEAR 


SALESJPERIOD 


SALES_TARGET 


Jan 12, 2004 12:00:00 AM 


$39,036,796.40 


2004 


1 


57,623,100 


Jan 13, 2004 12:00:00 AM 


$11,488,458.59 


2004 


2 


67,795,500 


Jan 14, 2004 12:00:00 AM 


$3,232,160.48 


2004 


3 


69,741,700 


Jan 15, 2004 12:00:00 AM 


$3,080,441.44 


2004 


4 


59,954,700 


Jan 16, 2004 12:00:00 AM 


$1,976,896.69 


2004 


5 


67,525,900 


Jan 19, 2004 12:00:00 AM 


$2,159,831.74 


2004 


6 


73,594,900 



The year and period (month) from S AT T S_T A R GET do not match those in 
the ORDER_DATE from Sales Fact. You cannot get expected results without 
using a time dimension or creating calculations or modeling complex summary 
queries that manipulate date fields to tie the data together. 

For example, you could extract the year and month from ORDER_DATE to 
match the fields in SAT ES_T A R GET using functions such as: 

• Y ear (ORDER_D ATE) 

• Month(ORDER_DATE) 
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You could then sort in ascending order on the two new columns in order to 
match them to the SALES_YEAR and SALES_PERIOD columns from 
SALES_TARGET. 

However, this cannot be accomplished in Query Studio and therefore requires 
the modeler to create the calculations or restricts these types of calculations to 
Report Studio authors. The results also do not properly stitch the two fact 
queries because the items used to compare the data do not come from a 
conformed source. 

5. Return to IBM Cognos Connection, and do not save the report. 

Results: 

You identified the complexity of trying to create a time-based report 
without a time dimension. Without a conformed time dimension, you 
cannot achieve a proper stitch query and require calculations in 
order to match date fields from different sources. 
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A time dimension provides a conformed dimension to allow time-based queries across 
facts, either at the same or different levels of granularity. Currendy the model being 
built in this course has various date formats in the fact tables (such as 
ORDER_DATE, SALES_PERIOD) that make time-based queries between facts 
difficult. Time dimensions also allow for easy rollups, for example, day-based facts can 
be rolled up to the month level. 

A time dimension can be easily created by creating a table with all applicable dates for a 
time period, ensuring that it includes all required keys, date derivatives, and formats. 
There are several SQL scripts that can be found on the internet to build time 
dimensions. You can use any of the popular Internet search engines to find them. 
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You can import the time dimension into Framework Manager and create relationships 
as necessary. If the fact query subjects do not contain the required keys to relate to the 
time dimension, speak to the database administrator to see if they can be incorporated. 

You can also create time keys in Framework Manager using calculations, but this may 
reduce performance since you are filtering on non-indexed fields. 
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Demo 2: Implement a Time Dimension 



Purpose: 

In order to perform predictable time-based queries, you will import 
and implement a time dimension. 



Components: Framework Manager, Query Studio, Report Studio 

Project: GO Operational 

Package: GO Operational 

Task 1. Import Time Dimension metadata. 

1. In Framework Manager, in the Project Viewer pane, expand Foundation 
Objects View, right-click the gosales namespace, and then click Run 
Metadata Wizard. 

2. Ensure that Data Sources is selected, and then click Next. 

3. Ensure that GOSALES is selected, and then click Next. 

4. In the list of objects, expand GOSALES>Tables, and then select 

TIME_DIMENSION. 

5. Click Next, and then click Import. 

6. Click Finish. 
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Task 2. Test and adjust TIME_DIMENSION. 

1 . Drag TIME_DIMENSION below the Staff Region (alias) query subject to 
organize it alphabetically. 

2. Right-click TIME_DIMENSION, click Launch Context Explorer, and then 
click Show Related Objects. 

TI ME _DIM E N SI ON is a generic query subject with no relationships to other 
query subjects. 

3. Close Context Explorer. 

4. Right-click TIME_DIMENSION, click Test, and then click Test Sample. 

This query subject is simply a calendar breakdown, giving the time over a 
certain range in multiple formats. It can be used to join two fact tables with 
different date formats. In this case, TIM E _DI ME NSION’s DAY_DATE 
matches the format of Sales Fact’s ORDER_DATE and 
TIME_DIMENSION’s CURRENT_YEAR and CURRENT_MONTH 
match SAT ES_T A R GET 1 s SALES_YEAR and SAT ES_PERTOD. 

5. Click Close. 

6. Expand TIME_DIMENSION, cHck CURRENT_YEAR, and then, in the 

Properties pane beside Format, click <Click to edit>. 

Note: If your Properties pane is not visible, then from the View menu click 
Properties. 

7. Under Format type, select Number, set Use Thousands Separator to No, 

and then click OK. 

8. In the TIME_DIMENSION, set all query items' Usage property identified as 
Fact to Attribute. 
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Task 3. Build Relationships to the Facts. 

1 . In the Project Viewer pane, in the Foundation Objects View, create the 
following relationships: 

TIME_DIMEN SION (DAY_DATE, 1..1) to 
Sales Fact (ORDER_DATE, l..n) 

TIME_DIMEN SION (DAY_DATE, 1..1) to 
Returns Fact (RETURN_DATE, l..n) 

2. Create the following relationship but do not close the Relationship dialog box: 

TIME_DIMEN SION (CURRENT_YEAR, 1..1) to 
SALES TARGET (SALE S_YE AR, l..n) 

3. Click New Link to add a second segment to this two-segment relationship: 

TIMEJDIMENSION (CURRENT_MONTH, 1..1) to 
SALES TARGET (SALES_PERIOD, l..n) 



Query subject: Query subject: 

|TIME_DIMENSION jSl New Link I |SALES_TARGET 3 



DAY_KEY 
DAY_DATE 
MONTH KEY 



CURRENT MONTH 



QUARTER_KEY 

CURRENT_OUARTER 

CUFlRENT_YEAR 

DAY_OF_WEEK 

DAY_0F_M0NTH 

DAYSJN.MONTH 

DAY_OF_YEAR 

WFFK riF MflNTH 




I SALES. YEAR 



SALES PERIOD 



CO U N T R Y_C0 D E_R E T Al LE R 
SALE S_S T AFF_C0 D E 
RETAILER_CODE 
RETAILER_NAME 
PR 0 D U CT_T YPE_C0 D E 
PR 0 D U CT_B RAN D_C0 D E 
SALES TARGET 



Cardinality 

irfd 



Operator 




Cardinality 

irffl 
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Note the Expression below the linkages: 

TIME_DIMENSION.CURRENT_YEAR = 

SAT ES_T ARGET.SAI ES_YE A R 

AND TIME_DIMEN SION .CURRENT_MONTH - 

S AT ES_T ARGET.S AT ES_PERTOD 

This relationship now consists of two values in TIME_DIMENSION that 
match time period values in SAEES_TARGET. The fields used from the 
TIME_DIMENSION table, in this scenario, are not indexed in the database. 
This may affect performance. The ideal situation would be to have a month key 
in the S AT E S_T A R GET table in the database. This would allow you to create 
your relationship based on one common indexed key in each table. If this is not 
an option, you should consider asking the database administrator to index the 
CURRENT_MONTH and CURRENT_YEAR fields in the 
TTM E DTM E NST ON table if performance is an issue. 

4. Click OK 

Task 4. Create the Time model query subject in the 

Consolidation View. 

1 . Right-click Consolidation View, point to Create, and then click Query 
Subject. 

2. Name the query subject Time, and then, with Model selected, click OK. 

3. In the Available Model Objects pane, expand Foundation Objects View> 
gosales>TIME_DIMENSION. 
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4. Add the following query items by double-clicking them, and then click OK. 

• CURRENT_YEAR 

• QUARTERKEY 

• CURRENT_QUARTER 

• MONTH_KEY 

• CURRENT_MONTH 

• MONTH_EN 

• DAY_KEY 

• DAY_DATE 

You will include only the columns your report authors require. 

5. Rename the items with more user friendly names. 

• CURRENT_YEAR to Year 

• QUARTER_KEY to Quarter Key 

• CURRENT_QUARTER to Quarter 

• MONTH_KEY to Month Key 

• CURRENT_MONTH to Month (numeric) 

• MONTH_EN to Month 

• DAY_KEY to Day Key 

• DAY_DATE to Date 
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6. Organize the items as shown below: 



- bbb Time 




. 


L Year 




■■■■ [jjjl Quarter Key 




. 


Quarter 






[ Month Key 




. 


| Month (numeric) 




. 


[ Month 




Oft! Day Key 




Oft! Date 



7. Drag Time above the Model Filters folder. 

8. Save the project. 

Task 5. Prepare the model for multilingual data. 

1 . Right-click Model Calculations, point to Create and click Calculation. 

2. In the Name box, type Month. 

3. In the Available Components box, navigate to Foundation Objects View> 
gosales>TIME_DIMENSION and drag the MONTH_EN data item into 
the Expression definition box. 

4. In the Expression definition box, add #’ in front of [gosales] and replace 
EN] with ’ + $Language_lookup{$runLocale} + 

The completed expression should read as follows: 

#’ [gosales] . [TIME_DIMEN SION] . [MONTH_ f + $Language_lookup 
($runLocale}+'] ’# 

5. Click OK, and then save the project. 
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Task 6. Publish and test package. 

1 . Publish the GO Operational package. 

2. In IBM Cognos Connection, launch Query Studio, and then select the GO 
Operational package. 

3. Create a new report with the following items from Consolidation View: 



Query Subject 


Query Item 


Time 


Year 

Month (numeric) 


Sales Target Fact 


Sales T arget 



The results appear as follows: 



Year 


Month ^numeric) 


Sa!es Target 


2004 


1 


1,786,471,100 


2004 


2 


1,966,069,500 


2004 


3 


2 r 161,99 2, 700 



Knowing your business, and recalling the Sales Target values in the first demo, 
you can see that monthly sales targets are in the billions and this is too high. 
Double counting is occurring because there is not enough information specified 
on the time dimension to allow IBM Cognos to roll up values correctly at the 
month. You will need to specify determinants for the underlying 
TIME_DIMEN SION query subject to resolve this issue. 

You will specify determinants in the next module. 

4. Save the query as Test Time Dimension. 

You will now test a multi-fact query using the Time dimension as a conformed 
dimension. 
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5. Create a new report with the following items from Consolidation View: 



Query Subject 


Query Item 


Time 


Year 

Month (Numeric) 


Sales Fact 


Revenue 


Returns Fact 


Return Quantity 



The results appear as follows: 



Year 


Month (numeric) 


Revenue 


Return Quantity 


2004 


1 


$72,741,622.65 


596 


2004 


2 


$73,242,343.99 


3,129 


2004 


3 


$75,720,238.67 


10,341 


2004 


4 


$65,273,353.76 


17,393 


2004 


5 


$74,695,218.83 


27,693 


2004 


6 


$32,169,306.93 


43,562 


■nirin.^ 


”7 


J-on 7ii3 a c~t 


cn oriT 



This multi-fact query was accomplished using Time as a conformed dimension 
to stitch the two fact queries together. 

To verify this, you will open the report in Report Studio to view the SQL. 

6. Under Menu, click Manage File, and then click Open in Report Studio. 

7. In Report Studio, from the Tools menu, click Show Generated SQL/MDX. 
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8. From the drop down list, select IBM Cognos SQL. 
The results appear as follows: 

Generated SQL/MDX: 



IBM Cognos SQL ▼ 

select 

coalesce 332/Year 1,03. Year 1} as Year!, 

coalesce ;’D2. Month ntimeric_, D3 , Month numericj as Month numeric^ 

D 2. Revenue as Revenue., 

D3.Retum_Quantity as Return_Quantity. r 
XSUM[D2. Revenue ) as Revenues, 

XSUM[D3.Retiirn_Quantity ) as Return_Quantity6 
from 
(select: 

TIME J3IMEN5IGN , CURREMT_YEAR as Year!, 

TIME_DIMENSION , C URRENT_MOHTH as Month^numerio 

XSUM(Sales_=act. Revenue for TIME_DIMENSIDN . CURREMTJfEAR ,TIME_DIMENSION . C URREHT_MONTH ) as Revenue 
from 

GOS ALES. .GOS ALES. TIME_DIMENSIDN TIME_DIMENSION, 

(select 

ORDER_HE ADER . ORDER_D ATE as ORDER_DATE , 

(ORDERJ3ET AILS . QUANTIFY *= ORDER_DET AILS . UN1T_S ALE_PRICE) as Revenue 
from 

GOSALES- . GOS ALES . DRDERJHEADER ORDER_HE ADER, 

GOS ALES, . GOS ALES . ORDER_DET AILS QRDER_DETAILS 
where 

(ORDER _HEADER.ORDER_NUMBER = ORDER_DET AILS . ORDERJ-JUMBER) 

) Sales_Fact 
where 

:1TME_DIMENSI0N.DAY_DATE = Sales_ = act . ORDERJD ATE} 
group by 

TIME_DIMENSION . CURRENT_YEAR, 

TIME_DIMENSION . CURREMT_MONTH 

^jj^uteyoir^^J 

(select 

TIME_DIMENSION . CURRENTJV'EAR as Yearl, 

TIME_DIMENSION . CURRENT_MONTH as Month_numeric_, 

vn •y ~^- ms Eact m Ouanfih^ fonTIME r ElElEUI YEAR-TIME DIMEMSIQh C 1RREMI MQMIldJ as 

If you scroll through the SQL, you will see that there are two queries merged 
together using a full outer join. 

9. Click Close, close Report Studio, and then close your browser. 



Results: 

By implementing a Time dimension, you can now easily query 
across fact query subjects. You did however discover that Sales 
Target values are not correct and will correct this later in the 
modeling process using determinants. 
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A table with multiple valid relationships between itself and another table presents a 
reporting trap. Sales Fact, for example, has three possible ways of joining to the Time 
dimension. To ensure that queries use the correct relationship, create two additional 
aliases for the Time dimension and assign each a role: one links to Sales Fact by Order 
Date, one by Ship Date, and one by Close Date. 
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Demo 3: Resolve Multiple Ambiguous Joins 



Purpose: 

Report authors require queries based on shipping and closing dates 
as well as the standard order date. However, while analyzing your 
model design, you see that this causes multiple relationships 
between Sales Fact and Time. The proper join may not be performed 
at run time. You will resolve this ambiguity by creating role-playing 
dimensions for each relationship. 



Component: Framework Manager 

Project: GO Operational 

Task 1. Use Model Advisor to Identify the Issue (Instructor- 

only). 

1. In Foundation Objects View>gosales, launch the Context Explorer for 
Sales Fact, and then double-click the relationship to TIME_DIMENSION. 

If necessary, click Show Related Objects I . 

Note that DAY_DATE is joined to ORDER_DATE, but should also have a 
relationship to ORDER_CLOSE_DATE and SHIP_DATE. 

2. Click Cancel, close Context Explorer, and then create two more relationships 
between TIME_DIMENSION and Sales Fact: 

DAY_DATE (1..1) to ORDER_CLOSE_DATE (l..n) 

DAY_DATE (1..1) to SHIP_DATE (l..n) 
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Launch Context Explorer for Sales Fact, and then click Show Related 
Objects. 

The results appear as follows: 



m 





ORDER_NUMEER 
RETAILER_SITE_CODE 
RET AIL£R_C0NT ACTjCODE 
SALES STAFFCODE 
SALES_BRAHC H_CODE 
OR D ER_D ATE 
OR D E R_C LOSE_D AT E 
OR D E R_M ET HOD_COD E 
OR D ER_D ET Al L_COD E 
SHIP DATE 



B 







DD 



E DIMEN SIO 



DAY_KEY 

DAY_DATE 

MONTH_KEY 

CURRENT_MONTH 

QUART ER_KEY 

0 U R R ENT_QU ART ER 

CURRENT_YEAR 

DAY_OF_WEEK 

DAY_OF_MOWTH 

DAYS IN MONTH 




— 



Notice the multiple relationships between Sales Fact and 
TIME_DIMENSION. You cannot use the relationships in this state and get 
expected results. Which relationship should be used and when? There is not 
enough information for IBM Cognos to select the correct relationship. 

You will implement role playing time dimensions to handle ship dates and close 
dates. 

Delete the two new relationships on SHIP_DATE and 

ORDER_CLOSE_DATE, and then close the Context Explorer. 
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Task 2. Create a Role-Playing Dimension. 

1 . In the gosales namespace, create a new model query subject called Time 
(Close) (alias), and then click OK. 

2. In the Available Model Objects pane, expand Foundation Objects View> 
gosales>TIME_DIMENSION, and then double-click to add the following 
query items to the definition: 

• CURRENT_YEAR 

• QUARTER_KEY 

• CURRENT_QUARTER 

• MONTH_KEY 

• CURRENT_MONTH 

• MONTH_EN 

• DAY_KEY 

• DAY_DATE 

3. Click OK, and then drag Time (Close) (alias) below TIME_DIMENSION. 

4. Create the following relationship, clicking No when prompted to recreate other 
relationships: 

Time (Close) (alias) (DAY_DATE, 1..1) to Sales Fact 
(ORDER_CLOSE_DATE, l..n) 
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5. In Time (Close) (alias), rename the following data items: 

• DAY_DATE to Close Date 

• CURRENT_YEAR to Close Year 

• QUARTER_KEY to Close Quarter Key 

• CURRENT_QUARTER to Close Quarter 

• MONTH_KEY to Close Month Key 

• CURRENT_MONTH to Close Month (numeric) 

• MONTH_EN to Close Month 

• DAY_KEY to Close Day Key 

6. Repeat steps 1 to 4 to create Time (Ship) (alias) with the following 
relationship, renaming DAY_DATE to Ship Date, and moving Time (Ship) 
(alias) below Time (Close) (alias). 

Time (Ship) (alias) (Ship Date, 1..1) to Sales Fact (SHIP_DATE, l..n) 
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DIMENSION 



7. In Time (Ship) (alias), rename the following data items: 

• DAY_DATE to Ship Date 

• CURRENT_YEAR to Ship Year 

• QUARTERKEY to Ship Quarter Key 

• CURRENT_QUARTER to Ship Quarter 

• MONTH_KEY to Ship Month Key 

• CURRENT_MONTH to Ship Month (numeric) 

• MONTH_EN to Ship Month 

• DAY_KEY to Ship Day Key 

Tip: You can make a copy of Time (Close) (alias) and edit as required to save 
time. Also, if you have renamed and prefixed all Time (Close) (alias) query 
items, when you make a copy, you can use the bulk replace feature to 
change the Close prefix to a Ship prefix to save time. 

8. Double-click Close Month, delete the expression in the Expression definition 
box, then double-click the Month calculation in the Foundation Objects 
View under gosales>Reusable Objects>Model Calculations to add it to the 
expression. Repeat this process for Ship Month. 
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9. Select and test the following query items: 



Query Subject 


Query Item 


Sales Fact 


ORDER_NUMBER 


TIME_DIMEN SION 


DAY_DATE 


Time (Ship) (alias) 


Ship Date 


Time (Close) (alias) 


Close Date 


Sales Fact 


Quantity 



The results appear as follows: 



T est results 


ORDER .NUMBER 


DAY_DATE 


Close Date 


Ship Date 


Quantity 


1 00001 


Jan 12, 200412:00:00 AM 


Feb 17, 2004 12:00:00 AM 


Jan 19, 2004 12:00:00 AM 


256 1 


1 00001 


Jan 12, 2004 12:00:00 AM 


Feb 17, 2004 12:00:00 AM 


Feb 17, 2004 12:00:00 AM 


92 


1 00002 


Jan 12, 2004 12:00:00 AM 


Jan 19, 2004 12:00:00 AM 


Jan 19, 2004 12:00:00 AM 


162 


1 00002 


Jan 12, 2004 12:00:00 AM 


Jan 19, 2004 12:00:00 AM 


Jan 19, 2004 12:00:00 AM 


172 


1 00002 


Jan 12, 2004 12:00:00 AM 


Jan 19, 2004 12:00:00 AM 


Jan 19, 2004 12:00:00 AM 


74 



Notice that the dates in each column accurately represent the order dates, ship 
dates, and close dates. For most dates in this test result the close date is the 
same day as the ship date. But notice that the first record has a later close date. 
Larger orders do not always ship all products on the same day. 

10. Click Close, and then save and close the project. 

Results: 

You saw that multiple relationships between Sales Fact and Time 
meant that a proper join might not be performed at run time. You 
resolved this ambiguity by creating role-playing dimensions for the 
SHIP_DATE and O RD E R_C LOS E_D ATE relationships. 
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Business Analytics iEhE^z 

Summary 

■ You should now be able to: 

■ make time-based queries simple to author by 
implementing a time dimension 

■ resolve confusion caused by multiple relationships 
between a time dimension and another table 



Coanos. 

software 

©2010 IBM Corporation 
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Business Analytics 

Objectives 

■ At the end of this module, you should be able to: 

■ use determinants to specify multiple levels of 
granularity and prevent double-counting 



Coaitos. 

software 

©2010 IBM Corporation 
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Business Analytics 



Framework Manager Workflow 



Framework Manager 



Create 

Project 




Import 

Metadata 



Prepare 

Metadata 



Publish 



Set 

Security 



Model 

Metadata for 
Reporting 



I 



Create and 
Manage 
Packages 



Data 

Sources 



Content 

Store 



Report Studio 
Query Studio 
Analysis Studio 



Coanos. 
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This module teaches the technique of specifying determinants to prevent double- 
counting. 
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Business Analytics =^==^?§: 

IBM Cognos Determinants 

** Recommendation #7 

■ Determinants are a feature of IBM Cognos typically 
used to provide control over granularity when 
aggregating. 

■ Required for dimensions connected to facts at levels 
of granularity that have repeating keys. 

■ Other cases requiring determinants include: 

■ preventing distinct clause on unique keys 

■ BLOB data types in the query subject 

■ improving performance on dimensionally modeled 

relational (DMR) metadata Cognos* 

software 

©2010 IBM Corporation 



Typically, determinants are specified to provide IBM Cognos with information to 
correctly aggregate facts in queries. Determinants are tied to the relationships their keys 
represent and are only used when the corresponding relationship is used in a query. 

Determinants on alternate unique values in the data (such as surrogate keys or dates) , 
which may or may not be used in a relationship, can prevent the generation of the 
distinct clause in the select statement when summa r izing the data. Selecting distinct 
values unnecessarily can reduce performance because you are scanning the entire table 
or index for a field. If the values are tmly unique, then there is no need to scan for 
distinct values. 

Querying Binary Large Objects (BLOB) requires additional key and index type 
information. If this information is not present in the data source, you can add it using 
determinants. 
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To leverage indexes with DMR (especially when filtering on captions) associating your 
captions with the correct key in a determinant will improve query generation. 

There is no concept of hierarchy in determinants, although the order in which they are 
specified does govern the order in which they are evaluated. 
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Business Analytics 



Determinants: Time Dimension Example 

Recommendation #7 




Time dimensions 
may contain 
several levels of 
granularity (Year, 
Month, Day) 

Use determinants 
to specify levels for 
grouping 



Coanos. 

software 
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In the slide example above, each unique instance of MONTH_KEY repeats once for 
every day in the month. 

If you do not tell IBM Cognos that MONTH_KEY requires grouping at the month 
level, your queries will double-count S AFE S T ARGET for every day of the month. 
Setting a determinant at each level of granularity avoids any potential instances of 
double-counting. 
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Business Analytics 



Specify Determinants 

Data Set Example #1 

Data 



Recommendation #7 



Year Key 


Month Key 


Month Name 


Day Key 


Day Name 


2005 


200501 


Jan 05 


20050101 


Sunday, Jan 1, 2005 


2005 


200501 


Jan 05 


20050102 


Monday, Jan 2, 2005 



Determinant Settings 






Name 


Key 


Attributes 


Uniquely Identified 


Group By 


Year 


Year Key 


None 


No 


Yes 


Month 


Month Key 


Month Name 


No 


Yes 


Day 


Day Key 


Day Name 
Month Key 
Month Name 
Year Key 


Yes 


No 



Cognos, 

software 
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For the data set above, it is possible to define three determinants, two non-unique 
determinants (based on Year Key and Month Key), and one unique determinant (based 
on Day Key) . 

Day Key is the unique key of the table; therefore you can associate all the columns in 
the table to this key. Because it is a unique key at the lowest level of granularity, you 
check the Uniquely Identified setting and do not check the Group By setting. 

Month Key is also a key but it is not unique since it repeats in the data (once for every 
day in the month). Uniquely Identified is not checked for this determinant. If you 
wanted to query month from this time table, you would write a query that used select 
min function syntax and group by the Month Key. That is why you check the Group 
By box in the determinant setting. 
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Similar logic is applied to the Year determinant. 

When a query is created using a column from the table above, the IBM Cognos query 
engine evaluates the determinants, based on the relationship used in the query, one at a 
time until it finds the column reference (either the key or an attribute of the key) in a 
determinant and then stops when it finds it. For example, if you chose Month Name 
and Sales Target (Sales Target has a relationship to the Time dimension on the Month 
Key), IBM Cognos would evaluate the Year determinant and see that there is no 
reference to Month Name. It would then move on to the Month determinant and find 
the Month Name reference and stop evaluating. It would then generate the appropriate 
SQL and group on the Month Key. 

Ensure that the key for each determinant includes the key or keys that identify the data 
set. 
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Business Analytics 



Specify Determinants (cont'd) 

Recommendation #7 



Data Set Example #2 

Data 



Year Key 


Month Key 


Month Name 


Day Key 


Day Name 


2005 


01 


January 


20050101 


Sunday, Jan 1, 2005 


2005 


01 


January 


20050102 


Monday, Jan 2, 2005 



Determinant Settings 



Name 


Key 


Attributes 


Uniquely Identified 


Group By 


Year 


Year Key 


None 


No 


Yes 


Month 


Year Key, Month Key 


Month Name 


No 


Yes 


Day 


Day Key 


Day Name 
Month Key 
Month Name 
Year Key 


Yes 


No 



Coqnos. 

software 
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In the event a key requires another key to provide uniqueness to identify the row of 
data, you need to nest the keys. For example, looking at the Month Key above, you can 
not identify which year it belongs to without looking at the Year Key. Therefore, the 
Month determinant nests the Year Key and the Month Key to generate the proper 
grouping in the SQL at mn time. In this case the grouping would combine Year Key 
and Month Key. 
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Demo 1 : Specify Determinants on the Time Dimension 



Purpose: 

A typical business report compares the monthly sales targets to 
actual sales. In a previous test you discovered that sales target 
values were being double-counted in report summary footers. You 
will specify determinants on TIME_DIMENSION to correct this 
problem. 



Components: Framework Manager, Query Studio 

Project: GO Operational 

Package: GO Operational 

Task 1 . Review double-counting issue. 

1. In Framework Manager, close any projects that may be open, and then open 

the GO Operational project located at C:\Edcognos\B5152\CBIFM-Start 
Files\Module ll\GO Operational. 

2. If prompted, log in as User ID admin, and Password Education!.!. 

3. Launch IBM Cognos Connection, log on, and then click IBM Cognos 
content. 
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4. Click GO Operational, and then click Test Time Dimension. 

The results appear as follows: 



Year 


Month (numeric) 


Sales Target 


2004 


1 


1 ,750,471 ,1 00 


2005 


1 


2,330,209,000 


200'S 


1 


2,077,230,900 


2007 


1 


3,000,501,440 


2004 


2 


1,906,009,500 


2005 


2 


2,580,573,000 


2000 


2 


3,199,294,000 


2007 


2 


4,402,913,200 


2004 


3 


2,101,992,700 



Again, knowing your business, you can see that monthly sales targets are in the 
billions, which is too high. Double counting occurs because there is not enough 
information specified on the time dimension to allow IBM Cognos to roll up 
values correcdy at the month. The target value is counted once for every day in 
a month rather than just once for each month. You will specify determinants 
for the underlying TI ME _DI ME NSI ON query subject to resolve this issue. 

5. Click Return in the top right corner. 

Task 2. Examine keys and unique values in TIME_DIMENSION. 

1 . In Framework Manger, in Foundation Objects View>gosales, right-click 
TIME_DIMENSION, and then click Launch Context Explorer. 

2. Click Show Related Objects, click Auto Layout, ensure Star is selected, and 
then click Apply. 
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3. Click Close. 



The results appear similar to as follows: 




When specifying determinants, it is good practice to view the relationships to 
the object and examine the keys used in the relationships. In this case 
DAY_DATE, not DAY_KEY, is used to relate to Returns Fact and Sales Fact. 
This is an important piece of information for your determinant at the day level. 
Also, the relationship to SALES_TARGET is based on CURRENT_YEAR 
and CURRENT_MONTH. The determinants should reflect the relationships. 
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Before applying determinants on TIM E _DIM E NSI ON you will also quickly 
test effects of having no determinants on a unique value in the data. In this case 
DAY_DATE is unique. 

4. Close Context Explorer, expand TIME_DIMENSION and then test the 
DAY_DATE query item with Auto Sum enabled. 

5. Click the Query Information tab. 

The results appear as follows: 

Cog n os SQL 

select 

T IME_D IMENS I ON . D AY_D ATE as D AY_D ATE 

from 

GOS A LE S ■ GOS A LE S . go sales . T IME_D IMENS I ON T IME D IMENS I ON 

Notice the distinct clause in the select statement. This is unnecessary as the 
DAY_DATE values in this table are all unique. You will now specify 
determinants to reflect your relationships and also observe that the distinct 
clause will not be applied when querying DAY_DATE. 

6. Click Close. 
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Task 3. Specify determinants in TIME_DIMENSION. 

1. In the Project Viewer, double-click TIME_DIMENSION, and then click 
the Determinants tab. 



2 . 

3 . 

4 . 



The results appear as follows: 



Determinants: 



Name 


Uniquely Identified 


Group By 


DAY_KEY 


f 


r 












































| Add 


X Delete 



Select a determinant to see its keys and attributes. 

Key: Attributes 




ID WEEKDAY_PL 
U MONTH_PT 
U W EEKD AY_PT 
ID MONTH_RU 



During import, the primary key value is used to create a determinant for you. 
This value is unique and therefore all other values in the table can be associated 
with it. But in the case of your relationship to Sales Fact and Returns Fact, the 
DAY_KEY is not used in the relationship but rather DAY_DATE. You will 
alter this determinant to reflect your relationship. 



Under Key, select DAY_KEY, and then press Delete. 

Under Available items, drag DAY_DATE to the Key pane. 
You will now add the remaining determinants. 

Under the Determinants pane, click Add. 



New Determinant appears below DAY_KEY in the Determinants pane. 
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5. Right-click New Determinant, and then click Rename. 

6. Type Year, and then press Enter. 

7. Click the Up Arrow key on the right to move Year above DAY_KEY. 

8. From the Available items pane, drag CURRENT_YEAR to the Key pane. 

9. Select the Group By check box beside Year. 

10. Repeat steps 4 to 9 to create Quarter, with Key = QUARTER_KEY. 

1 1 . With the focus still on Quarter, drag CURRENT_QUARTER into the 
Attributes box. 

12. Repeat steps 4 to 9 to create Month, with two Keys — 

CURRENT_MONTH and CURRENT_YEAR. 

CURRENT_MONTH and CURRENT_YEAR are used as the key for this 
determinant since the relationship to S ALE S_T ARGET is based on those two 
query items. These two fields uniquely identify the relationship to 
SALES_TARGET and therefore will be used to correctly aggregate sales target 
values. 

13. With the focus still on Month, drag the following items into the Attributes 
box: MONTH_KEY and all MONTH_xx items. 

Tip: Select the items using the Ctrl key. Then right-click one of the items and 
then click Add as Attributes. 

Typically MONTH_KEY would be used as the key for a determinant 
describing month data values. In this case however, MONTH_KEY is not used 
in any relationships, and therefore can act as an attribute of the Month 
determinant should the value be required in a report. If in the future you use 
this key in a relationship, you would need to reflect this in your determinants. 
You would need to create a new determinant to represent that relationship. 
Again, the ideal situation is to use a month key exclusively and consistently 
across all facts that report at the month level. These types of keys should be 
requested from the database administrator if they do not exist. 
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14. Rename the DAY_KEY determinant to Day. 



The results appear as follows: 



Determinants: 



Name 


Uniquely Identified 


Group By 


Year 


r 


p 


Quarter 


r 


p 


Month 


r 


p 


Day 


p 


r 



























Add ^ Debate 




Select a determinant to see Its keys and attributes. 

Key: .Attributes: 



El D AY_D AT E 


B 


DD month_sc 


pq 




E 


| WEEKDAY_SC 






n 


I mqnih_sv 






n 


| WEEKDAY_SV 






n 


| MONTH_TC 






n 


| WEEKDAY_TC 






n 


| MONTH_TH 






E 


| WEEKDAY,™ 


m 

Ml 



15. Click OK, and then save the project. 
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Task 4. Re-test DAY_DATE. 

1 . Under TIME_DIMEN SION, test DAY_DATE with Auto Sum enabled, 
and then click the Query Information tab. 

The results appear as follows: 




Notice that there is no longer a distinct clause in your select statement. This is 
because you have identified the DAY_DATE as the key and as being unique, 
therefore the IBM Cognos query engine has enough information to know it 
does not need to scan the table for distinct values. If you required another 
relationship later on using the DAY_KEY, then you would also specify a 
determinant on it and set it as unique. It is OK to have more than one unique 
determinant if they are truly unique. At query time, the relationship being used 
will determine which unique determent to use. If more than one relationship to 
a unique determinant is used, then each related determinant will be used in the 
query. 

2. Click Close. 

Task 5. Publish and Test the Package. 

1 . Publish the GO Operational package. 

2. In IBM Cognos Connection, click Test Time Dimension to mn the report 
again. 
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4 . 

5 . 

6 . 



When prompted to update the report, click OK 
The results appear as follows: 



Year 


Month [numeric) 


Sales Target 


2004 


1 


57.62S.100 


2004 


2 


67,795,500 


2004 


3 


69,741,700 


2004 


4 


59,954,700 


2004 


5 


67,525,000 


2004 


6 


73,594,900 



You now have accurate sales targets. 
Under Menu, click Insert Data. 



From the Consolidation View, add Time>Date and Sales Fact>Revenue 

to the report. 



Select Year and Month (numeric) and click Group 




The results appear as follows: 



Year 


Month ['numeric) 


Sa es Target 


Dote 


Revenue 


2004 


1 


57,628,100 


Jan 12, .200412:00:00 AM 


$39,036,796.40 






57,628, 100 


Jan 13, 2004 12:00:00 AM 


$11,488,458.59 






57,628, 100 


Jan 14, 2004 12:00:00 AM 


$3,2 32,160.48 






57,628,100 


Jan 15. 2004 12:00:00 AM 


$3,080,441.44 






57,628, 100 


Jan 16, 2004 12:00:00 AM 


$1,976,896.69 






57,628, 100 


Jan 19. 2004 12:00:00 AM 


$2,159,831.74 






57,628,100 


Jan 20, 2004 12:00:00 AM 


$2,558,694. 30 






57,628. 100 


Jan 21, 2004 12:00:00 AM 


$2,935,024.72 






57,628, 100 


Jan 22. 2004 12:00:00 AM 


$3,559,670.33 






57,628, 100 


Jan 23, 2004 12:00:00 AM 


$2,371,064.81 






57,628, 100 


Jan 24, 2004 12:00:00 AM 


$342,583.15 


i 


U 1 


57,628,100 




$72,741,622.65 | 




2 


67,795,500 


Feb % 2004 12:00:00 AM 


523,342,738.42 






f.7 7Q c - gnn 


Fch in Wi4 i >r in -nr. jm 


£5 fi'-T-i 7R4 1ft 



Note that although the sales targets repeat (because they are not at the day level) 
they are not double counted at the Month grouping level. 
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7. Select the Year column, and then click Filter. 

8. Set the From and To boxes to 2004, and then click OK. 

9. Select Month (numeric) column, and then click Filter. 

10. Set the From and To boxes to 1, and then click OK 



The results appear similar as follows: 



^ Year: 2004 AND Month fnumericl : 1 



Year 



Month Numeric} 



ZOO 4 1 



2004 

Summary 



Sales Target 


Date 


Revenue 


57,623, 100 


Jan 12, 2004 12:00:00 AM 


$39,036,796.40' 


57,623. 100 


Jan 13, 2004 12:00:00 AM 


$11,488,453.59 


57,623. 100 


Jan 14. 2004 12:00:00 AM 


$3,232, 160.48 


57,628,100 


Jan 15. 2004 12:00:00 AM 


$3,080,441.44 


57,628,100 


Jan 16, 2004 12:00:00 AM 


$1,976,896.69 


57,628. 100 


Jan 19, 2004 12:00:00 AM 


$2,159,831,74 


57,623,100 


Jan 20, 2004 12:00:00 AM 


$2,553,694.30 


57,623,100 


Jan 21, 2004 12:00:00 AM 


$2,935,024.72 


57,628. 100 


Jan 22. 2004 12:00:00 AM 


$3,559,670.33 


57,628,100 


Jan 23, 2004 12:00:00 AM 


$2,371,064.31 


57,628. 100 


Jan 24, 2004 12:00:00 AM 


$3 42,533.15 


57,628,100 




$72,741,622.65 


57,628,100 




$72,741,622.65 


57,628,100 




$72,741,622.65 



This will give you a smaller data set to conduct your next test. You will now add 
Product Line from Products to see the results. 
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11. From Products, drag Product Line onto the report after Month (numeric), 

and then click the Bottom link. 

The results appear similar as follows: 



^ Year: 2004 AND Month (numeric): 1 


Year 


Month {numeric} 


Product Line 


Sales Target 


Date 


Revenue 


2004 


1 


Outdoor Protection 


12,396,500 


Jan 12, 2004 12:00:00 AM 


$2,263,330.47 






Outdoor Protection 


12,396,500 


Jan 13, 2004 12:00:00 AM 


5474,025.75 






Outdoor Protection 


12,396,500 


Jan 14, 2004 12:00:00 AM 


$91,322.21 






Outdoor Protection 


12,396,500 


Jan 15, 2004 12:00:00 AM 


562,434.09 






Outdoor Protection 


12,396,500 


Jan 16, 2004 12:00:00 AM 


530,466.92 






Outdoor Protection 


12,396,500 


Jan 19, 2004 12:00:00 AM 


$11,636.03 






Outdoor Protection 


12,396,500 


Jan 21j 2004 12:00:00 AM 


$22,214.32 






Outdoor Protection 


12,396,500 


Jan 22, 2004 12:00:00 AM 


533,753.03 






Outdoor Protection 


12,396,500 


Jan 23, 2004 12:00:00 AM 


$50,249.23 






Personal Accessories 


1,220,801,200 


Jan 12, 2004 12:00:00 AM 


$7,414,443.06 






Personal Accessories 


1,220,801,200 


Jan 13, 2004 12:00:00 AM 


$3,477,197. 59 






Personal Accessories 


1,220,801,200 


Jan 14, 2004 12:00:00 AM 


$2,113,932.80 






Personal Accessories 


1,220,801,200 


Jan 15, 2004 12:00:00 AM 


$1,853,335,02 






Personal Accessories 


1,220,301,200 


Jan 16, 2004 12:00:00 AM 


$1,557,191.77 






Personal Accessories 


1,220,801,200 


Jan 19, 2004 12:00:00 AM 


$1,931,953.91 






Personal Accessories 


1,220,801,200 


Jan 20, 2004 12:00:00 AM 


$2,553,694.30 






Personal Accessories 


1,220,301,200 


Jan 21, 2004 12:00:00 AM 


$2,557,571.92 






Personal Accessories 


1,220,801,200 


Jan 22, 2004 12:00:00 AM 


$2,329,013.16 






Personal Accessories 


1,220,301,200 


Jan 23, 2004 12:00:00 AM 


$1,369,246.87 






Personal Accessories 


1,220,301,200 


Jan 24, 2004 12:00:00 AM 


$342,583.15 




1 


1,440,860,600 




$72,741,622.65 


2004 


1,440,860,600 




$72,741,622.65 


Summary 


1,440,860,600 




$72,741,622.65 



The sales target values are double-counted. You will examine and correct this 
issue in the next workshop. 

12. Save the report as Products Dimension Test, and then close your browser. 

Results: 

By specifying determinants on TIME_DIMENSION, you were able to 
correct a double-counting problem that occurred with sales targets. 
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In the slide example above, the Product Type & Product query subject is a query 
subject you merged earlier to remove ambiguity from PRODUCT_TYPE. Each 
unique instance of Product Type Code repeats once for every related product. If you 
do not specify determinants, sales target values will be double-counted for every 
product belonging to a particular product type. 

Again, you need to provide information to the IBM Cognos query engine that indicates 
Product Type Code requires grouping when queried against sales targets. 
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Workshop 1 : Specify Determinants 



Earlier in the modeling process, you merged some query subjects together to resolve 
ambiguous query subjects. You merged PRODUCT_TYPE and PRODUCT to create 
Product Type & Product, and you merged RETAI L ER and RET AI T E R_S1TE to 
create Retailer & Retailer Site. Both these query subjects now present multiple levels of 
granularity in them and cause double-counting when querying against sales targets. 

You will resolve this by specifying determinants on: 

• Product Type & Product 

• PRODUCT_NUMBER is unique 

• Group on PRODUCT_TYPE_CODE and add appropriate attributes 

• Retailer & Retailer Site 

• RETAILER_SITE_CODE is unique 

• Group on RETAILER_CODE and add appropriate attributes 

Test the Product Type & Product determinants using the Product Dimension Test 
report in IBM Cognos Connection. 

For more detailed information outlined as tasks, see the Task Table on the next page. 

To see the desired filters, see the Workshop Results section that follows the Task 
Table. 

Save the project when you are finished. 
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Workshop 1: Task Table 



Task Where to Work Hints 

1. Specify Project Viewer, • Double-click the query subject 

determinants for Query Subject 

Product Type & Definition • Click the Determinants tab 

Product. 

• Click Add 

• Name determinant Product 

• Add PRODUCT_NUMBER as the 

key 

• Select Uniquely Identified checkbox 

• Add new determinant called Product 
Type 

• Add PRODUCT_TYPE_CODE as 

the key 

• Add PRODU CT_LINE_CODE and 
all PRODUCT_TYPE_xx items to 
the Attributes pane 

• Select Group By check box 

• Move Product Type determinant to 
the top 
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Task Where to Work Hints 

2. Specify Project Viewer, • Double-click the query subject 

determinants for Query Subject 

Retailer & Retailer Definition • Click the Determinants tab 

Site. 

• Click Add 

• Name determinant Retailer Site 

• Add RETAILER_SITE_CODE as 

the key 

• Select Uniquely Identified checkbox 

• Add new determinant called Retailer 

• Add RETAILER_CODE as the key 

• Add COMPANY_NAME, 
COMPANY_NAME_MB, 
RETAILER_TYPE_CODE, and 
RETAILER_START_DATE to the 
Attributes pane 

• Select Group By check box 

• Move Retailer determinant to the top 

• Save project 

3. Test Products IBM Cognos • Publish Go Operational package 

Dimension Test Connection 

report. • Launch IBM Cognos Connection 

and mn Products Dimension Test 

• Close IBM Cognos Connection 
without saving and close Framework 
Manager, saving changes. 
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Workshop 1 : Workshop Results 



Your Product Type & Product determinants should appear as shown below: 



Determinants: 


Name 


Uniquely Identified 


Group By 


Product Type 


r 


p 


Product 


p 


r 






































U ] Add X Delete 


Select a determinant to see its keys and attributes. 

Key: Attributes: 


D^Iprod ucttyf e_co d e 


[ 

i 


J} PROD UCT_LINE_CODE 
| PRODUCT TYPE EN 
PRODUCT TYPE FR 
PRODUCT TYPE DE 
PRODUCT TYPE NL 
J PRODUCT TYPE JA 
PRODUCT TYPE SC 
PRODUCT TYPE KO 
PRODUCT TYPE CS 
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Workshop 1 : Workshop Results 



Your Retailer & Retailer Site determinants should appear as shown below: 



Determinants: 



Name 


Uniquely Identified 


Group By 


Retailer 


r 


p 


Retailer Site 


P 


r 







































\\ Add X Deists 



Select a determinant to see its keys and attributes. 

Key: Attributes: 



D3!retailer_code 



DDDcompanyjiame 




CO M P AN Y_N AH E_MB 
R ETAI LER_TYP E_CO D E 
RET A1LER_ST ART_D ATE 
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Workshop 1 : Workshop Results 



After scrolling to the bottom of the Products Dimension Test report, the results should 
appear similar as shown below: 



Y tear: 2004 AND Month {numeric): 1 


Year 


Month (numeric) 


Product Line 


Sales Target 


Date 


Revenue 


2004 


1 


Outdoor Protection 


2,479,300 


Jan 14. 2004 12:00:00 AM 


$ ,91,322.21 






Outdoor Protection 


2,479,300 


Jan 15, 2004 12:00:00 AM 


$62,434.09 






Outdoor Protection 


2,479,300 


Jan 16. 2004 12:00:00 AM 


580,466.92 






Outdoor Protection 


2,479,300 


Jan 19, 2004 12:00:00 AM 


$11,686.08 






Outdoor Protection 


2,479,300 


Jan 21, 2004 12:00:00 AM 


$22,214.32 






Outdoor Protection 


2,479,300 


Jan 22, 2004 12:00:00 AM 


.533,753.03 






Outdoor Protection 


2,479,300 


Jan 23, 2004 12:00:00 AM 


$50,249.28 






Personal Accessories 


22,2 18,600 


Jan 12, 2004 12:00:00 AM 


57,414,443,06 






Personal Accessories 


22,213,600 


Jan 13, 2004 12:00:00 AM 


$3,477, 197. 59 






Personal Accessories 


22,213,600 


Jan 14, 2004 12:00:00 AM 


$2,118,932,80 






Personal Accessories 


22,2 18,600 


Jan 15, 2004 12:00:00 AM 


$1,858,835,02 






Personal Accessories 


22,218,600 


Jan 16, 2004 12:00:00 AM 


$1,557,191.77 






Personal Accessories 


22,213,600 


Jan 19, 2004 12:00:00 AM 


$1,931,953,91 






Personal Accessories 


22,218,600 


Jan 20, 2004 12:00:00 AM 


$2,558,694.30 






Personal Accessories 


22,2 18,600 


Jan 21, 2004 12:00:00 AM 


$2,557,571.92 






Personal Accessories 


22,213,600 


Jan 22, 2O04 12:00:00 AM 


$2,329,018.16 






Personal Accessories 


22,2 18,600 


Jan 23, 2004 12:00:00 AM 


$1,869,246.87 






Personal Accessories 


22,218,600 


Jan 24. 2004 12:00:00 AM 


$342,583.15 




1 




57,628,100 




$72,741,622.65 


2004 






57,628,100 




$72,741,622.65 


Summary 




57,628,100 




$72,741,622.65 



Sales Target Values are not double-counted. 
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Business Analytics 

Summary 

■ You should now be able to: 

■ use determinants to specify multiple levels of 
granularity and prevent double-counting 









Goanos. 

software 

©2010 IBM Corporation 
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